landing

# Landing — Premium HTML Landing Page Generator

> **Distinct from `product-team/skills/landing-page-generator/`.** That skill outputs Next.js TSX components optimized for conversion / lead-gen. THIS skill outputs a single self-contained `.html` file optimized for premium visual experience with GSAP animations. Pick by use case.

Generate a polished, self-contained `.html` landing page from a text prompt or brief. The output is ONE HTML file: all CSS inline in `<style>`, all JS inline in `<script>`, only external dependencies being Google Fonts + GSAP via CDN. The page is visually distinctive, animated, and production-quality.

## Invocation Triggers

- "create a landing page"
- "build a landing page"
- "make a landing page for X"
- "I need a web page for Y"
- "promotional page"
- "product page"
- "one-pager"
- "web presence"
- "sales page"
- "landing for X"

## Delivery Mode

In **Claude Code CLI**, write the file to disk at the specified path. In **Claude.ai web**, create an HTML artifact with the same content.

## Phase 0: Grill-Me Intake (4 forcing questions, one at a time)

Dependency-ordered. Each question carries explicit "why I'm asking". Stop condition: max 4.

### Q1 (root) — Product / Service

> **What's the product or service? Give me the name + a 1–2 sentence elevator pitch — what does it do, and who's it for?**
>
> *Why I'm asking:* The headline, subtext, and feature copy all derive from this. "App for productivity" produces generic boilerplate; "Async standup tool for remote engineering teams who hate Zoom" produces a landing page that converts.

**Refuse mush.** If user gives just a name with no pitch, push back once: "What does it do? Who's it for?" If still no pitch after push-back, deliver with explicit "generic positioning" caveat.

### Q2 (depends on Q1) — Audience Register

> **Who's the audience? Pick one:**
>
> 1. **Technical buyers** (engineers, ops, security)
> 2. **Business buyers** (PMs, execs, ops leaders)
> 3. **Consumers** (general public, hobbyists)
> 4. **Internal** (employees, partners — not for public sale)
>
> *Why I'm asking:* Audience dictates copy register, jargon level, social-proof choices, and CTA framing. Technical buyers want specifics; consumers want benefits; internal pages can skip persuasion.

Forcing choice.

### Q3 (always) — Brand Overrides

> **Brand colors / fonts to override the default (dark navy + teal + Inter)? Provide as: primary HEX, accent HEX, optional bg HEX. Or say "default" if you want the polished default.**
>
> *Why I'm asking:* The default is intentionally beautiful, but matching your brand makes the page feel native to your existing site. Even just a primary color override goes a long way.

Accept "default" or partial overrides (e.g., just primary). If only primary provided, derive accent algorithmically (lighten / darken).

### Q4 (depends on Q1) — Tone

> **Tone — pick one:**
>
> 1. **Professional** — confident, restrained, B2B-friendly
> 2. **Playful** — warm, light, occasional humor
> 3. **Authoritative** — expert, data-forward, trust-building
> 4. **Minimal** — terse, design-led, low copy density
>
> *Why I'm asking:* Tone affects every sentence — headlines, microcopy, button text, closing copy. Picking upfront prevents tonal whiplash across sections.

Forcing choice. **Recommended default:** professional if Q2 = technical/business; playful if Q2 = consumer; minimal if the product is design-led.

**Stop condition:** After Q4, commit and generate. No follow-up questions during generation.

## Content Extraction (with Fallback Strategy)

From Q1's elevator pitch, derive:
- **Hero headline** — punchy version of "what it does" (8–12 words)
- **Hero subtext** — version of "who it's for + payoff" (1–2 sentences)
- **3–6 feature bullets** — distilled from pitch + audience (Q2) + tone (Q4)
- **CTA text** — action-oriented, matches tone
- **Closing copy** — short, emotive, matches tone

**Fallback when input is sparse:** invent compelling content from product-name semantics + audience register. Flag inferred content with a comment in the HTML source (`<!-- inferred: ... -->`). Don't stall waiting for more input.

## Brand System Specification

### Default Color Palette (Dark Navy + Teal)

```css
:root {
  --navy:       #0A1628;
  --navy-mid:   #0D1F38;
  --teal:       #00D4AA;
  --teal-glow:  rgba(0, 212, 170, 0.12);
  --amber:      #F5A623;
  --off-white:  #F7F7F2;
  --text-muted: rgba(247, 247, 242, 0.68);
  --card-bg:    rgba(0, 212, 170, 0.06);
  --card-border:rgba(0, 212, 170, 0.15);
}
```

### Override Pattern

When Q3 provides custom brand values, the skill substitutes them into the `:root` block:

```
Brand override:
- primary: #FF6B35    →  --navy / hero bg
- accent:  #2EC4B6    →  --teal / CTA / highlights
- bg:      #011627    →  --navy-mid / section bg
- text:    #FDFFFC    →  --off-white
```

If only primary provided, derive accent algorithmically (lighten 15% for accent; darken 8% for navy-mid; convert to rgba at 0.12 alpha for glow). Use `scripts/brand_palette_validator.py` for the deterministic derivation.

See [`references/brand_system_design.md`](references/brand_system_design.md) for color theory + WCAG + algorithmic palette derivation canon.

### Typography

- **Font family:** Inter (via Google Fonts)
- **Weight scale:** 400 (body), 500 (eyebrow), 600 (links), 700 (subtitle), 800 (H1 + H2)
- **Size scale:**
  - Hero H1: 68–82px
  - Section H2: 52–62px
  - Card titles: 22px
  - Body: 17–19px
  - Eyebrow: 13px (uppercase, letter-spaced)
  - CTA button: 18px (500 weight)

### Components (Must Specify CSS)

- `.btn-primary` — CTA button with hover state (lift + brightness)
- `.feature-card` — card with hover lift (translateY(-6px) + border-brighten)
- `.eyebrow` — letter-spaced (0.2em) uppercase category label

## Section 1: Hero

- `min-height: 100vh`, flex-centered content
- Optional eyebrow label above H1
- H1 (68–82px, 800 weight)
- Subtitle (17–19px, 1–2 sentences)
- CTA button (.btn-primary)
- Scroll-down indicator (animated chevron, CSS bounce)
- **Depth layers** (mouse parallax):
  - `.hero-shapes-back` — large blurred circles, absolute-positioned, low opacity
  - `.hero-shapes-mid` — smaller shapes, sharper edges, higher opacity
  - Content layer (H1 + subtitle) — moves subtly in same direction as mouse

## Section 2: Features

- 3 columns default (`repeat(3, 1fr)` grid)
- Responsive:
  - 2 columns at 900px breakpoint
  - 1 column at 580px breakpoint
- Each card:
  - SVG icon (28px, stroke=var(--teal), no fill)
  - Title (22px, 700 weight)
  - Description (15–16px, --text-muted)
- Hover state:
  - `transform: translateY(-6px)`
  - `border-color: var(--teal)` (brighten from --card-border)
  - `transition: 0.3s ease`

## Section 3: Closing CTA

- Full-width, `background: var(--navy-mid)`
- `padding: 120px 24px`, text-align: center
- Large closing headline (52–62px, 800 weight)
- Short subtext (--text-muted, 1–2 sentences)
- CTA button with ambient radial-gradient glow behind it:
  ```css
  background: radial-gradient(circle, var(--teal-glow) 0%, transparent 70%);
  ```

## Animation Patterns

See [`references/gsap_animation_patterns.md`](references/gsap_animation_patterns.md) for the canon. Five patterns required:

### 1. Hero Entrance (GSAP timeline)

```js
// MUST use gsap.set() FIRST to prevent FOUC
gsap.set([".eyebrow", ".hero h1", ".hero .subtitle", ".btn-primary", ".scroll-down"], {
  opacity: 0,
  y: 30
});

const tl = gsap.timeline({ defaults: { ease: "power3.out" } });
tl.to(".eyebrow", { opacity: 1, y: 0, duration: 0.6 })
  .to(".hero h1", { opacity: 1, y: 0, duration: 0.8 }, "-=0.3")
  .to(".hero .subtitle", { opacity: 1, y: 0, duration: 0.6 }, "-=0.5")
  .to(".btn-primary", { opacity: 1, y: 0, duration: 0.5 }, "-=0.3")
  .to(".scroll-down", { opacity: 1, y: 0, duration: 0.4 }, "-=0.2");
```

### 2. Mouse Parallax

```js
const hero = document.querySelector(".hero");
hero.addEventListener("mousemove", (e) => {
  const x = (e.clientX / window.innerWidth - 0.5) * 2;
  const y = (e.clientY / window.innerHeight - 0.5) * 2;
  gsap.to(".hero-shapes-back", { x: x * 45, y: y * 22, duration: 0.8 });
  gsap.to(".hero-shapes-mid",  { x: x * 22, y: y * 11, duration: 0.8 });
  gsap.to(".hero .container",  { x: x * 8,  y: y * 5,  duration: 0.8 });
});
```

### 3. Scroll-Triggered Feature Cards

```js
gsap.set(".feature-card", { opacity: 0, y: 55, rotateX: 18 });

ScrollTrigger.batch(".feature-card", {
  start: "top 80%",
  onEnter: batch => gsap.to(batch, {
    opacity: 1, y: 0, rotateX: 0,
    duration: 0.8,
    stagger: 0.11,
    ease: "power2.out"
  })
});
```

### 4. Floating Decorative Shapes (CSS keyframes — NOT GSAP)

CSS handles ambient continuous motion (smoother, cheaper than GSAP for indefinite animations):

```css
@keyframes floatA {
  0%, 100% { transform: translate(0, 0) rotate(0deg); }
  50%      { transform: translate(20px, -30px) rotate(8deg); }
}
@keyframes floatB { /* different duration + rotation */ }
@keyframes floatC { /* different duration + rotation */ }

.hero-shapes-back .shape-a { animation: floatA 12s ease-in-out infinite; }
```

### 5. Scroll Indicator (CSS bounce)

```css
@keyframes bounce {
  0%, 100% { transform: translateY(0); }
  50%      { transform: translateY(8px); }
}
.scroll-down { animation: bounce 2s ease-in-out infinite; }
```

## Required CDN Dependencies

```html
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&display=swap" rel="stylesheet">
<script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.2/gsap.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.2/ScrollTrigger.min.js"></script>
```

NO other external CSS or JS files. All custom CSS in `<style>`, all custom JS in `<script>` blocks within the same HTML file.

See [`references/single_file_html_discipline.md`](references/single_file_html_discipline.md) for the inline-only rationale.

## Layout Rules

- **Container max-width:** 1200px, centered
- **Section padding:** `120px 24px` (vertical 120, horizontal 24, scales down on mobile)
- **Responsive breakpoints:**
  - 900px → features grid 3-col → 2-col
  - 580px → all grids → 1-col; H1 scales down to ~52px
- **Viewport meta:** `<meta name="viewport" content="width=device-width, initial-scale=1">`

## Output Spec

- **Path:** `${OUTPUT_DIR}/<product-name-kebab>.html`
- **Default `${OUTPUT_DIR}`:** `./landing-pages/`
- **Filename:** lowercase kebab-case from product name ("Quill AI" → `quill-ai.html`). Use `scripts/kebab_slug_generator.py` for deterministic slug generation + duplicate detection.
- **Self-contained:** all CSS in `<style>`, all JS in `<script>`, only Google Fonts + GSAP CDN external.

## Validation (Post-Generation)

Run `scripts/html_validator.py --file ${OUTPUT_DIR}/<slug>.html` after generation. Checks:

- All 3 required sections present (`.hero`, `.features`, `.closing-cta`)
- CDN deps present (Inter + GSAP + ScrollTrigger)
- `gsap.set()` initial states precede any `gsap.timeline` or `gsap.to` (FOUC prevention)
- Responsive breakpoints at 900px + 580px
- No external `<link rel="stylesheet">` other than Google Fonts
- No external `<script src=>` other than GSAP CDN
- `<meta name="viewport">` present
- All animated elements have initial-state declarations

## Error Handling

| Situation | Behavior |
|---|---|
| Input is just a name with no context | Invent compelling content from name semantics + audience register; flag as `<!-- inferred -->` in HTML source |
| Input file is large or PDF | Read fully before generating; don't truncate |
| Brand colors insufficient (only 1 HEX provided) | Use as primary; derive secondary/accent algorithmically (lighten/darken via brand_palette_validator.py) |
| Features count not specified | Default to 4 |
| Output dir doesn't exist | Create it |
| Existing file at output path | Append timestamp suffix or ask user (kebab_slug_generator.py flags duplicates) |
| html_validator returns FAIL | Regenerate ONLY the failing sections in one targeted pass; do NOT abandon the file |

## Portability

- **Claude Code CLI:** Native — writes HTML file directly to filesystem.
- **Claude.ai web:** Native — produces HTML as an artifact instead of file.

## Tooling

| Script | Role |
|---|---|
| `scripts/brand_palette_validator.py` | Validates HEX format, checks WCAG AA contrast, generates derived palette from primary (algorithmic lighten/darken). |
| `scripts/kebab_slug_generator.py` | Product name → kebab-case filename + duplicate detection in output dir. |
| `scripts/html_validator.py` | Post-generation structural check: 3 sections, CDN deps, gsap.set() initial states, responsive breakpoints, no external files. |

## References

- [`references/brand_system_design.md`](references/brand_system_design.md) — color theory + WCAG + algorithmic palette derivation (7+ sources)
- [`references/gsap_animation_patterns.md`](references/gsap_animation_patterns.md) — entrance timeline + ScrollTrigger reveals + mouse parallax + CSS floats + scroll indicator (7+ sources)
- [`references/single_file_html_discipline.md`](references/single_file_html_discipline.md) — why inline + CDN-only externals + accessibility minimums + no-build rationale (7+ sources)

## Anti-Patterns To Reject

- Hardcoded absolute paths in output directory
- Single brand palette without override documentation
- Outlining before writing — write in one pass
- External CSS or JS files (must be inline; only Google Fonts + GSAP CDN allowed)
- Skipping `gsap.set()` initial states (causes FOUC)
- More than 6 features in default grid (becomes unscannable)
- Brand-specific content references in the skill itself

---

**Version:** 1.0.0
**Source spec:** `megaprompts/04-landing-megaprompt.md` (maintainer-local draft spec — gitignored, not present in the public repository)
**Build pattern:** Path B (direct conversion). Distinct from `product-team/skills/landing-page-generator/`.

{
  "format": "aiskill/v1",
  "skill": {
    "name": "landing",
    "slug": "landing",
    "version": "1.0.0",
    "description": "Generates a premium single-page HTML landing page with 3D CSS animations, GSAP scroll effects, and mouse-parallax depth. Forcing intake (product + elevator pitch, audience register, brand overrides, tone) locks down positioning before any copy or markup is written, so the page reflects the actual product rather than generic boilerplate. Use whenever the user says 'landing for X', 'create a landing page', 'build a landing page', 'make a landing page for X', 'I need a web page for Y', or provides product/service details and wants a polished website. Also triggers on 'promotional page', 'product page', 'one-pager', 'web presence', 'sales page'. Outputs a single self-contained HTML file (Claude Code) or HTML artifact (Claude.ai). Supports configurable brand colors via CSS custom property overrides.",
    "category": "Marketing",
    "tags": [
      "marketing-growth"
    ],
    "platforms": [
      "chatgpt",
      "claude-code",
      "cursor"
    ],
    "tested_environment": "Agent Skills convention (SKILL.md) — works with Claude Code, Cursor, ChatGPT/Codex and compatible agents",
    "license": "MIT"
  },
  "prompts": {
    "system": "# Landing — Premium HTML Landing Page Generator\r\n\r\n> **Distinct from `product-team/skills/landing-page-generator/`.** That skill outputs Next.js TSX components optimized for conversion / lead-gen. THIS skill outputs a single self-contained `.html` file optimized for premium visual experience with GSAP animations. Pick by use case.\r\n\r\nGenerate a polished, self-contained `.html` landing page from a text prompt or brief. The output is ONE HTML file: all CSS inline in `<style>`, all JS inline in `<script>`, only external dependencies being Google Fonts + GSAP via CDN. The page is visually distinctive, animated, and production-quality.\r\n\r\n## Invocation Triggers\r\n\r\n- \"create a landing page\"\r\n- \"build a landing page\"\r\n- \"make a landing page for X\"\r\n- \"I need a web page for Y\"\r\n- \"promotional page\"\r\n- \"product page\"\r\n- \"one-pager\"\r\n- \"web presence\"\r\n- \"sales page\"\r\n- \"landing for X\"\r\n\r\n## Delivery Mode\r\n\r\nIn **Claude Code CLI**, write the file to disk at the specified path. In **Claude.ai web**, create an HTML artifact with the same content.\r\n\r\n## Phase 0: Grill-Me Intake (4 forcing questions, one at a time)\r\n\r\nDependency-ordered. Each question carries explicit \"why I'm asking\". Stop condition: max 4.\r\n\r\n### Q1 (root) — Product / Service\r\n\r\n> **What's the product or service? Give me the name + a 1–2 sentence elevator pitch — what does it do, and who's it for?**\r\n>\r\n> *Why I'm asking:* The headline, subtext, and feature copy all derive from this. \"App for productivity\" produces generic boilerplate; \"Async standup tool for remote engineering teams who hate Zoom\" produces a landing page that converts.\r\n\r\n**Refuse mush.** If user gives just a name with no pitch, push back once: \"What does it do? Who's it for?\" If still no pitch after push-back, deliver with explicit \"generic positioning\" caveat.\r\n\r\n### Q2 (depends on Q1) — Audience Register\r\n\r\n> **Who's the audience? Pick one:**\r\n>\r\n> 1. **Technical buyers** (engineers, ops, security)\r\n> 2. **Business buyers** (PMs, execs, ops leaders)\r\n> 3. **Consumers** (general public, hobbyists)\r\n> 4. **Internal** (employees, partners — not for public sale)\r\n>\r\n> *Why I'm asking:* Audience dictates copy register, jargon level, social-proof choices, and CTA framing. Technical buyers want specifics; consumers want benefits; internal pages can skip persuasion.\r\n\r\nForcing choice.\r\n\r\n### Q3 (always) — Brand Overrides\r\n\r\n> **Brand colors / fonts to override the default (dark navy + teal + Inter)? Provide as: primary HEX, accent HEX, optional bg HEX. Or say \"default\" if you want the polished default.**\r\n>\r\n> *Why I'm asking:* The default is intentionally beautiful, but matching your brand makes the page feel native to your existing site. Even just a primary color override goes a long way.\r\n\r\nAccept \"default\" or partial overrides (e.g., just primary). If only primary provided, derive accent algorithmically (lighten / darken).\r\n\r\n### Q4 (depends on Q1) — Tone\r\n\r\n> **Tone — pick one:**\r\n>\r\n> 1. **Professional** — confident, restrained, B2B-friendly\r\n> 2. **Playful** — warm, light, occasional humor\r\n> 3. **Authoritative** — expert, data-forward, trust-building\r\n> 4. **Minimal** — terse, design-led, low copy density\r\n>\r\n> *Why I'm asking:* Tone affects every sentence — headlines, microcopy, button text, closing copy. Picking upfront prevents tonal whiplash across sections.\r\n\r\nForcing choice. **Recommended default:** professional if Q2 = technical/business; playful if Q2 = consumer; minimal if the product is design-led.\r\n\r\n**Stop condition:** After Q4, commit and generate. No follow-up questions during generation.\r\n\r\n## Content Extraction (with Fallback Strategy)\r\n\r\nFrom Q1's elevator pitch, derive:\r\n- **Hero headline** — punchy version of \"what it does\" (8–12 words)\r\n- **Hero subtext** — version of \"who it's for + payoff\" (1–2 sentences)\r\n- **3–6 feature bullets** — distilled from pitch + audience (Q2) + tone (Q4)\r\n- **CTA text** — action-oriented, matches tone\r\n- **Closing copy** — short, emotive, matches tone\r\n\r\n**Fallback when input is sparse:** invent compelling content from product-name semantics + audience register. Flag inferred content with a comment in the HTML source (`<!-- inferred: ... -->`). Don't stall waiting for more input.\r\n\r\n## Brand System Specification\r\n\r\n### Default Color Palette (Dark Navy + Teal)\r\n\r\n```css\r\n:root {\r\n  --navy:       #0A1628;\r\n  --navy-mid:   #0D1F38;\r\n  --teal:       #00D4AA;\r\n  --teal-glow:  rgba(0, 212, 170, 0.12);\r\n  --amber:      #F5A623;\r\n  --off-white:  #F7F7F2;\r\n  --text-muted: rgba(247, 247, 242, 0.68);\r\n  --card-bg:    rgba(0, 212, 170, 0.06);\r\n  --card-border:rgba(0, 212, 170, 0.15);\r\n}\r\n```\r\n\r\n### Override Pattern\r\n\r\nWhen Q3 provides custom brand values, the skill substitutes them into the `:root` block:\r\n\r\n```\r\nBrand override:\r\n- primary: #FF6B35    →  --navy / hero bg\r\n- accent:  #2EC4B6    →  --teal / CTA / highlights\r\n- bg:      #011627    →  --navy-mid / section bg\r\n- text:    #FDFFFC    →  --off-white\r\n```\r\n\r\nIf only primary provided, derive accent algorithmically (lighten 15% for accent; darken 8% for navy-mid; convert to rgba at 0.12 alpha for glow). Use `scripts/brand_palette_validator.py` for the deterministic derivation.\r\n\r\nSee [`references/brand_system_design.md`](references/brand_system_design.md) for color theory + WCAG + algorithmic palette derivation canon.\r\n\r\n### Typography\r\n\r\n- **Font family:** Inter (via Google Fonts)\r\n- **Weight scale:** 400 (body), 500 (eyebrow), 600 (links), 700 (subtitle), 800 (H1 + H2)\r\n- **Size scale:**\r\n  - Hero H1: 68–82px\r\n  - Section H2: 52–62px\r\n  - Card titles: 22px\r\n  - Body: 17–19px\r\n  - Eyebrow: 13px (uppercase, letter-spaced)\r\n  - CTA button: 18px (500 weight)\r\n\r\n### Components (Must Specify CSS)\r\n\r\n- `.btn-primary` — CTA button with hover state (lift + brightness)\r\n- `.feature-card` — card with hover lift (translateY(-6px) + border-brighten)\r\n- `.eyebrow` — letter-spaced (0.2em) uppercase category label\r\n\r\n## Section 1: Hero\r\n\r\n- `min-height: 100vh`, flex-centered content\r\n- Optional eyebrow label above H1\r\n- H1 (68–82px, 800 weight)\r\n- Subtitle (17–19px, 1–2 sentences)\r\n- CTA button (.btn-primary)\r\n- Scroll-down indicator (animated chevron, CSS bounce)\r\n- **Depth layers** (mouse parallax):\r\n  - `.hero-shapes-back` — large blurred circles, absolute-positioned, low opacity\r\n  - `.hero-shapes-mid` — smaller shapes, sharper edges, higher opacity\r\n  - Content layer (H1 + subtitle) — moves subtly in same direction as mouse\r\n\r\n## Section 2: Features\r\n\r\n- 3 columns default (`repeat(3, 1fr)` grid)\r\n- Responsive:\r\n  - 2 columns at 900px breakpoint\r\n  - 1 column at 580px breakpoint\r\n- Each card:\r\n  - SVG icon (28px, stroke=var(--teal), no fill)\r\n  - Title (22px, 700 weight)\r\n  - Description (15–16px, --text-muted)\r\n- Hover state:\r\n  - `transform: translateY(-6px)`\r\n  - `border-color: var(--teal)` (brighten from --card-border)\r\n  - `transition: 0.3s ease`\r\n\r\n## Section 3: Closing CTA\r\n\r\n- Full-width, `background: var(--navy-mid)`\r\n- `padding: 120px 24px`, text-align: center\r\n- Large closing headline (52–62px, 800 weight)\r\n- Short subtext (--text-muted, 1–2 sentences)\r\n- CTA button with ambient radial-gradient glow behind it:\r\n  ```css\r\n  background: radial-gradient(circle, var(--teal-glow) 0%, transparent 70%);\r\n  ```\r\n\r\n## Animation Patterns\r\n\r\nSee [`references/gsap_animation_patterns.md`](references/gsap_animation_patterns.md) for the canon. Five patterns required:\r\n\r\n### 1. Hero Entrance (GSAP timeline)\r\n\r\n```js\r\n// MUST use gsap.set() FIRST to prevent FOUC\r\ngsap.set([\".eyebrow\", \".hero h1\", \".hero .subtitle\", \".btn-primary\", \".scroll-down\"], {\r\n  opacity: 0,\r\n  y: 30\r\n});\r\n\r\nconst tl = gsap.timeline({ defaults: { ease: \"power3.out\" } });\r\ntl.to(\".eyebrow\", { opacity: 1, y: 0, duration: 0.6 })\r\n  .to(\".hero h1\", { opacity: 1, y: 0, duration: 0.8 }, \"-=0.3\")\r\n  .to(\".hero .subtitle\", { opacity: 1, y: 0, duration: 0.6 }, \"-=0.5\")\r\n  .to(\".btn-primary\", { opacity: 1, y: 0, duration: 0.5 }, \"-=0.3\")\r\n  .to(\".scroll-down\", { opacity: 1, y: 0, duration: 0.4 }, \"-=0.2\");\r\n```\r\n\r\n### 2. Mouse Parallax\r\n\r\n```js\r\nconst hero = document.querySelector(\".hero\");\r\nhero.addEventListener(\"mousemove\", (e) => {\r\n  const x = (e.clientX / window.innerWidth - 0.5) * 2;\r\n  const y = (e.clientY / window.innerHeight - 0.5) * 2;\r\n  gsap.to(\".hero-shapes-back\", { x: x * 45, y: y * 22, duration: 0.8 });\r\n  gsap.to(\".hero-shapes-mid\",  { x: x * 22, y: y * 11, duration: 0.8 });\r\n  gsap.to(\".hero .container\",  { x: x * 8,  y: y * 5,  duration: 0.8 });\r\n});\r\n```\r\n\r\n### 3. Scroll-Triggered Feature Cards\r\n\r\n```js\r\ngsap.set(\".feature-card\", { opacity: 0, y: 55, rotateX: 18 });\r\n\r\nScrollTrigger.batch(\".feature-card\", {\r\n  start: \"top 80%\",\r\n  onEnter: batch => gsap.to(batch, {\r\n    opacity: 1, y: 0, rotateX: 0,\r\n    duration: 0.8,\r\n    stagger: 0.11,\r\n    ease: \"power2.out\"\r\n  })\r\n});\r\n```\r\n\r\n### 4. Floating Decorative Shapes (CSS keyframes — NOT GSAP)\r\n\r\nCSS handles ambient continuous motion (smoother, cheaper than GSAP for indefinite animations):\r\n\r\n```css\r\n@keyframes floatA {\r\n  0%, 100% { transform: translate(0, 0) rotate(0deg); }\r\n  50%      { transform: translate(20px, -30px) rotate(8deg); }\r\n}\r\n@keyframes floatB { /* different duration + rotation */ }\r\n@keyframes floatC { /* different duration + rotation */ }\r\n\r\n.hero-shapes-back .shape-a { animation: floatA 12s ease-in-out infinite; }\r\n```\r\n\r\n### 5. Scroll Indicator (CSS bounce)\r\n\r\n```css\r\n@keyframes bounce {\r\n  0%, 100% { transform: translateY(0); }\r\n  50%      { transform: translateY(8px); }\r\n}\r\n.scroll-down { animation: bounce 2s ease-in-out infinite; }\r\n```\r\n\r\n## Required CDN Dependencies\r\n\r\n```html\r\n<link href=\"https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&display=swap\" rel=\"stylesheet\">\r\n<script src=\"https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.2/gsap.min.js\"></script>\r\n<script src=\"https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.2/ScrollTrigger.min.js\"></script>\r\n```\r\n\r\nNO other external CSS or JS files. All custom CSS in `<style>`, all custom JS in `<script>` blocks within the same HTML file.\r\n\r\nSee [`references/single_file_html_discipline.md`](references/single_file_html_discipline.md) for the inline-only rationale.\r\n\r\n## Layout Rules\r\n\r\n- **Container max-width:** 1200px, centered\r\n- **Section padding:** `120px 24px` (vertical 120, horizontal 24, scales down on mobile)\r\n- **Responsive breakpoints:**\r\n  - 900px → features grid 3-col → 2-col\r\n  - 580px → all grids → 1-col; H1 scales down to ~52px\r\n- **Viewport meta:** `<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">`\r\n\r\n## Output Spec\r\n\r\n- **Path:** `${OUTPUT_DIR}/<product-name-kebab>.html`\r\n- **Default `${OUTPUT_DIR}`:** `./landing-pages/`\r\n- **Filename:** lowercase kebab-case from product name (\"Quill AI\" → `quill-ai.html`). Use `scripts/kebab_slug_generator.py` for deterministic slug generation + duplicate detection.\r\n- **Self-contained:** all CSS in `<style>`, all JS in `<script>`, only Google Fonts + GSAP CDN external.\r\n\r\n## Validation (Post-Generation)\r\n\r\nRun `scripts/html_validator.py --file ${OUTPUT_DIR}/<slug>.html` after generation. Checks:\r\n\r\n- All 3 required sections present (`.hero`, `.features`, `.closing-cta`)\r\n- CDN deps present (Inter + GSAP + ScrollTrigger)\r\n- `gsap.set()` initial states precede any `gsap.timeline` or `gsap.to` (FOUC prevention)\r\n- Responsive breakpoints at 900px + 580px\r\n- No external `<link rel=\"stylesheet\">` other than Google Fonts\r\n- No external `<script src=>` other than GSAP CDN\r\n- `<meta name=\"viewport\">` present\r\n- All animated elements have initial-state declarations\r\n\r\n## Error Handling\r\n\r\n| Situation | Behavior |\r\n|---|---|\r\n| Input is just a name with no context | Invent compelling content from name semantics + audience register; flag as `<!-- inferred -->` in HTML source |\r\n| Input file is large or PDF | Read fully before generating; don't truncate |\r\n| Brand colors insufficient (only 1 HEX provided) | Use as primary; derive secondary/accent algorithmically (lighten/darken via brand_palette_validator.py) |\r\n| Features count not specified | Default to 4 |\r\n| Output dir doesn't exist | Create it |\r\n| Existing file at output path | Append timestamp suffix or ask user (kebab_slug_generator.py flags duplicates) |\r\n| html_validator returns FAIL | Regenerate ONLY the failing sections in one targeted pass; do NOT abandon the file |\r\n\r\n## Portability\r\n\r\n- **Claude Code CLI:** Native — writes HTML file directly to filesystem.\r\n- **Claude.ai web:** Native — produces HTML as an artifact instead of file.\r\n\r\n## Tooling\r\n\r\n| Script | Role |\r\n|---|---|\r\n| `scripts/brand_palette_validator.py` | Validates HEX format, checks WCAG AA contrast, generates derived palette from primary (algorithmic lighten/darken). |\r\n| `scripts/kebab_slug_generator.py` | Product name → kebab-case filename + duplicate detection in output dir. |\r\n| `scripts/html_validator.py` | Post-generation structural check: 3 sections, CDN deps, gsap.set() initial states, responsive breakpoints, no external files. |\r\n\r\n## References\r\n\r\n- [`references/brand_system_design.md`](references/brand_system_design.md) — color theory + WCAG + algorithmic palette derivation (7+ sources)\r\n- [`references/gsap_animation_patterns.md`](references/gsap_animation_patterns.md) — entrance timeline + ScrollTrigger reveals + mouse parallax + CSS floats + scroll indicator (7+ sources)\r\n- [`references/single_file_html_discipline.md`](references/single_file_html_discipline.md) — why inline + CDN-only externals + accessibility minimums + no-build rationale (7+ sources)\r\n\r\n## Anti-Patterns To Reject\r\n\r\n- Hardcoded absolute paths in output directory\r\n- Single brand palette without override documentation\r\n- Outlining before writing — write in one pass\r\n- External CSS or JS files (must be inline; only Google Fonts + GSAP CDN allowed)\r\n- Skipping `gsap.set()` initial states (causes FOUC)\r\n- More than 6 features in default grid (becomes unscannable)\r\n- Brand-specific content references in the skill itself\r\n\r\n---\r\n\r\n**Version:** 1.0.0\r\n**Source spec:** `megaprompts/04-landing-megaprompt.md` (maintainer-local draft spec — gitignored, not present in the public repository)\r\n**Build pattern:** Path B (direct conversion). Distinct from `product-team/skills/landing-page-generator/`.",
    "user_template": ""
  },
  "variables": [],
  "install": {
    "steps": [
      {
        "title": "Download & unzip",
        "detail": "Download the .zip package from SkillVault and unzip it. The landing/ folder contains SKILL.md plus any companion scripts, references and assets."
      },
      {
        "title": "Copy into your agent skills directory",
        "detail": "Move the folder into your agent's skills directory — e.g. ~/.claude/skills/ (Claude Code), .codex/skills/, .cursor/skills/ or your project's .claude/skills/ folder — then restart or reload the session."
      },
      {
        "title": "Use it",
        "detail": "Describe the task in natural language; the agent loads the skill automatically when the request matches the skill description."
      }
    ]
  },
  "usage": {
    "steps": []
  },
  "metadata": {
    "author": "SkillVault",
    "source": "https://skillvault.top/skills/landing",
    "exported_at": "2026-11-03T07:43:57.598Z"
  }
}

format: aiskill/v1
skill:
  name: landing
  slug: landing
  version: 1.0.0
  description: >-
    Generates a premium single-page HTML landing page with 3D CSS animations, GSAP scroll effects,
    and mouse-parallax depth. Forcing intake (product + elevator pitch, audience register, brand
    overrides, tone) locks down positioning before any copy or markup is written, so the page
    reflects the actual product rather than generic boilerplate. Use whenever the user says 'landing
    for X', 'create a landing page', 'build a landing page', 'make a landing page for X', 'I need a
    web page for Y', or provides product/service details and wants a polished website. Also triggers
    on 'promotional page', 'product page', 'one-pager', 'web presence', 'sales page'. Outputs a
    single self-contained HTML file (Claude Code) or HTML artifact (Claude.ai). Supports
    configurable brand colors via CSS custom property overrides.
  category: Marketing
  tags:
    - marketing-growth
  platforms:
    - chatgpt
    - claude-code
    - cursor
  tested_environment: >-
    Agent Skills convention (SKILL.md) — works with Claude Code, Cursor, ChatGPT/Codex and
    compatible agents
  license: MIT
prompts:
  system: "# Landing — Premium HTML Landing Page Generator\r\n\r\n> **Distinct from `product-team/skills/landing-page-generator/`.** That skill outputs Next.js TSX components optimized for conversion / lead-gen. THIS skill outputs a single self-contained `.html` file optimized for premium visual experience with GSAP animations. Pick by use case.\r\n\r\nGenerate a polished, self-contained `.html` landing page from a text prompt or brief. The output is ONE HTML file: all CSS inline in `<style>`, all JS inline in `<script>`, only external dependencies being Google Fonts + GSAP via CDN. The page is visually distinctive, animated, and production-quality.\r\n\r\n## Invocation Triggers\r\n\r\n- \"create a landing page\"\r\n- \"build a landing page\"\r\n- \"make a landing page for X\"\r\n- \"I need a web page for Y\"\r\n- \"promotional page\"\r\n- \"product page\"\r\n- \"one-pager\"\r\n- \"web presence\"\r\n- \"sales page\"\r\n- \"landing for X\"\r\n\r\n## Delivery Mode\r\n\r\nIn **Claude Code CLI**, write the file to disk at the specified path. In **Claude.ai web**, create an HTML artifact with the same content.\r\n\r\n## Phase 0: Grill-Me Intake (4 forcing questions, one at a time)\r\n\r\nDependency-ordered. Each question carries explicit \"why I'm asking\". Stop condition: max 4.\r\n\r\n### Q1 (root) — Product / Service\r\n\r\n> **What's the product or service? Give me the name + a 1–2 sentence elevator pitch — what does it do, and who's it for?**\r\n>\r\n> *Why I'm asking:* The headline, subtext, and feature copy all derive from this. \"App for productivity\" produces generic boilerplate; \"Async standup tool for remote engineering teams who hate Zoom\" produces a landing page that converts.\r\n\r\n**Refuse mush.** If user gives just a name with no pitch, push back once: \"What does it do? Who's it for?\" If still no pitch after push-back, deliver with explicit \"generic positioning\" caveat.\r\n\r\n### Q2 (depends on Q1) — Audience Register\r\n\r\n> **Who's the audience? Pick one:**\r\n>\r\n> 1. **Technical buyers** (engineers, ops, security)\r\n> 2. **Business buyers** (PMs, execs, ops leaders)\r\n> 3. **Consumers** (general public, hobbyists)\r\n> 4. **Internal** (employees, partners — not for public sale)\r\n>\r\n> *Why I'm asking:* Audience dictates copy register, jargon level, social-proof choices, and CTA framing. Technical buyers want specifics; consumers want benefits; internal pages can skip persuasion.\r\n\r\nForcing choice.\r\n\r\n### Q3 (always) — Brand Overrides\r\n\r\n> **Brand colors / fonts to override the default (dark navy + teal + Inter)? Provide as: primary HEX, accent HEX, optional bg HEX. Or say \"default\" if you want the polished default.**\r\n>\r\n> *Why I'm asking:* The default is intentionally beautiful, but matching your brand makes the page feel native to your existing site. Even just a primary color override goes a long way.\r\n\r\nAccept \"default\" or partial overrides (e.g., just primary). If only primary provided, derive accent algorithmically (lighten / darken).\r\n\r\n### Q4 (depends on Q1) — Tone\r\n\r\n> **Tone — pick one:**\r\n>\r\n> 1. **Professional** — confident, restrained, B2B-friendly\r\n> 2. **Playful** — warm, light, occasional humor\r\n> 3. **Authoritative** — expert, data-forward, trust-building\r\n> 4. **Minimal** — terse, design-led, low copy density\r\n>\r\n> *Why I'm asking:* Tone affects every sentence — headlines, microcopy, button text, closing copy. Picking upfront prevents tonal whiplash across sections.\r\n\r\nForcing choice. **Recommended default:** professional if Q2 = technical/business; playful if Q2 = consumer; minimal if the product is design-led.\r\n\r\n**Stop condition:** After Q4, commit and generate. No follow-up questions during generation.\r\n\r\n## Content Extraction (with Fallback Strategy)\r\n\r\nFrom Q1's elevator pitch, derive:\r\n- **Hero headline** — punchy version of \"what it does\" (8–12 words)\r\n- **Hero subtext** — version of \"who it's for + payoff\" (1–2 sentences)\r\n- **3–6 feature bullets** — distilled from pitch + audience (Q2) + tone (Q4)\r\n- **CTA text** — action-oriented, matches tone\r\n- **Closing copy** — short, emotive, matches tone\r\n\r\n**Fallback when input is sparse:** invent compelling content from product-name semantics + audience register. Flag inferred content with a comment in the HTML source (`<!-- inferred: ... -->`). Don't stall waiting for more input.\r\n\r\n## Brand System Specification\r\n\r\n### Default Color Palette (Dark Navy + Teal)\r\n\r\n```css\r\n:root {\r\n  --navy:       #0A1628;\r\n  --navy-mid:   #0D1F38;\r\n  --teal:       #00D4AA;\r\n  --teal-glow:  rgba(0, 212, 170, 0.12);\r\n  --amber:      #F5A623;\r\n  --off-white:  #F7F7F2;\r\n  --text-muted: rgba(247, 247, 242, 0.68);\r\n  --card-bg:    rgba(0, 212, 170, 0.06);\r\n  --card-border:rgba(0, 212, 170, 0.15);\r\n}\r\n```\r\n\r\n### Override Pattern\r\n\r\nWhen Q3 provides custom brand values, the skill substitutes them into the `:root` block:\r\n\r\n```\r\nBrand override:\r\n- primary: #FF6B35    →  --navy / hero bg\r\n- accent:  #2EC4B6    →  --teal / CTA / highlights\r\n- bg:      #011627    →  --navy-mid / section bg\r\n- text:    #FDFFFC    →  --off-white\r\n```\r\n\r\nIf only primary provided, derive accent algorithmically (lighten 15% for accent; darken 8% for navy-mid; convert to rgba at 0.12 alpha for glow). Use `scripts/brand_palette_validator.py` for the deterministic derivation.\r\n\r\nSee [`references/brand_system_design.md`](references/brand_system_design.md) for color theory + WCAG + algorithmic palette derivation canon.\r\n\r\n### Typography\r\n\r\n- **Font family:** Inter (via Google Fonts)\r\n- **Weight scale:** 400 (body), 500 (eyebrow), 600 (links), 700 (subtitle), 800 (H1 + H2)\r\n- **Size scale:**\r\n  - Hero H1: 68–82px\r\n  - Section H2: 52–62px\r\n  - Card titles: 22px\r\n  - Body: 17–19px\r\n  - Eyebrow: 13px (uppercase, letter-spaced)\r\n  - CTA button: 18px (500 weight)\r\n\r\n### Components (Must Specify CSS)\r\n\r\n- `.btn-primary` — CTA button with hover state (lift + brightness)\r\n- `.feature-card` — card with hover lift (translateY(-6px) + border-brighten)\r\n- `.eyebrow` — letter-spaced (0.2em) uppercase category label\r\n\r\n## Section 1: Hero\r\n\r\n- `min-height: 100vh`, flex-centered content\r\n- Optional eyebrow label above H1\r\n- H1 (68–82px, 800 weight)\r\n- Subtitle (17–19px, 1–2 sentences)\r\n- CTA button (.btn-primary)\r\n- Scroll-down indicator (animated chevron, CSS bounce)\r\n- **Depth layers** (mouse parallax):\r\n  - `.hero-shapes-back` — large blurred circles, absolute-positioned, low opacity\r\n  - `.hero-shapes-mid` — smaller shapes, sharper edges, higher opacity\r\n  - Content layer (H1 + subtitle) — moves subtly in same direction as mouse\r\n\r\n## Section 2: Features\r\n\r\n- 3 columns default (`repeat(3, 1fr)` grid)\r\n- Responsive:\r\n  - 2 columns at 900px breakpoint\r\n  - 1 column at 580px breakpoint\r\n- Each card:\r\n  - SVG icon (28px, stroke=var(--teal), no fill)\r\n  - Title (22px, 700 weight)\r\n  - Description (15–16px, --text-muted)\r\n- Hover state:\r\n  - `transform: translateY(-6px)`\r\n  - `border-color: var(--teal)` (brighten from --card-border)\r\n  - `transition: 0.3s ease`\r\n\r\n## Section 3: Closing CTA\r\n\r\n- Full-width, `background: var(--navy-mid)`\r\n- `padding: 120px 24px`, text-align: center\r\n- Large closing headline (52–62px, 800 weight)\r\n- Short subtext (--text-muted, 1–2 sentences)\r\n- CTA button with ambient radial-gradient glow behind it:\r\n  ```css\r\n  background: radial-gradient(circle, var(--teal-glow) 0%, transparent 70%);\r\n  ```\r\n\r\n## Animation Patterns\r\n\r\nSee [`references/gsap_animation_patterns.md`](references/gsap_animation_patterns.md) for the canon. Five patterns required:\r\n\r\n### 1. Hero Entrance (GSAP timeline)\r\n\r\n```js\r\n// MUST use gsap.set() FIRST to prevent FOUC\r\ngsap.set([\".eyebrow\", \".hero h1\", \".hero .subtitle\", \".btn-primary\", \".scroll-down\"], {\r\n  opacity: 0,\r\n  y: 30\r\n});\r\n\r\nconst tl = gsap.timeline({ defaults: { ease: \"power3.out\" } });\r\ntl.to(\".eyebrow\", { opacity: 1, y: 0, duration: 0.6 })\r\n  .to(\".hero h1\", { opacity: 1, y: 0, duration: 0.8 }, \"-=0.3\")\r\n  .to(\".hero .subtitle\", { opacity: 1, y: 0, duration: 0.6 }, \"-=0.5\")\r\n  .to(\".btn-primary\", { opacity: 1, y: 0, duration: 0.5 }, \"-=0.3\")\r\n  .to(\".scroll-down\", { opacity: 1, y: 0, duration: 0.4 }, \"-=0.2\");\r\n```\r\n\r\n### 2. Mouse Parallax\r\n\r\n```js\r\nconst hero = document.querySelector(\".hero\");\r\nhero.addEventListener(\"mousemove\", (e) => {\r\n  const x = (e.clientX / window.innerWidth - 0.5) * 2;\r\n  const y = (e.clientY / window.innerHeight - 0.5) * 2;\r\n  gsap.to(\".hero-shapes-back\", { x: x * 45, y: y * 22, duration: 0.8 });\r\n  gsap.to(\".hero-shapes-mid\",  { x: x * 22, y: y * 11, duration: 0.8 });\r\n  gsap.to(\".hero .container\",  { x: x * 8,  y: y * 5,  duration: 0.8 });\r\n});\r\n```\r\n\r\n### 3. Scroll-Triggered Feature Cards\r\n\r\n```js\r\ngsap.set(\".feature-card\", { opacity: 0, y: 55, rotateX: 18 });\r\n\r\nScrollTrigger.batch(\".feature-card\", {\r\n  start: \"top 80%\",\r\n  onEnter: batch => gsap.to(batch, {\r\n    opacity: 1, y: 0, rotateX: 0,\r\n    duration: 0.8,\r\n    stagger: 0.11,\r\n    ease: \"power2.out\"\r\n  })\r\n});\r\n```\r\n\r\n### 4. Floating Decorative Shapes (CSS keyframes — NOT GSAP)\r\n\r\nCSS handles ambient continuous motion (smoother, cheaper than GSAP for indefinite animations):\r\n\r\n```css\r\n@keyframes floatA {\r\n  0%, 100% { transform: translate(0, 0) rotate(0deg); }\r\n  50%      { transform: translate(20px, -30px) rotate(8deg); }\r\n}\r\n@keyframes floatB { /* different duration + rotation */ }\r\n@keyframes floatC { /* different duration + rotation */ }\r\n\r\n.hero-shapes-back .shape-a { animation: floatA 12s ease-in-out infinite; }\r\n```\r\n\r\n### 5. Scroll Indicator (CSS bounce)\r\n\r\n```css\r\n@keyframes bounce {\r\n  0%, 100% { transform: translateY(0); }\r\n  50%      { transform: translateY(8px); }\r\n}\r\n.scroll-down { animation: bounce 2s ease-in-out infinite; }\r\n```\r\n\r\n## Required CDN Dependencies\r\n\r\n```html\r\n<link href=\"https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&display=swap\" rel=\"stylesheet\">\r\n<script src=\"https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.2/gsap.min.js\"></script>\r\n<script src=\"https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.2/ScrollTrigger.min.js\"></script>\r\n```\r\n\r\nNO other external CSS or JS files. All custom CSS in `<style>`, all custom JS in `<script>` blocks within the same HTML file.\r\n\r\nSee [`references/single_file_html_discipline.md`](references/single_file_html_discipline.md) for the inline-only rationale.\r\n\r\n## Layout Rules\r\n\r\n- **Container max-width:** 1200px, centered\r\n- **Section padding:** `120px 24px` (vertical 120, horizontal 24, scales down on mobile)\r\n- **Responsive breakpoints:**\r\n  - 900px → features grid 3-col → 2-col\r\n  - 580px → all grids → 1-col; H1 scales down to ~52px\r\n- **Viewport meta:** `<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">`\r\n\r\n## Output Spec\r\n\r\n- **Path:** `${OUTPUT_DIR}/<product-name-kebab>.html`\r\n- **Default `${OUTPUT_DIR}`:** `./landing-pages/`\r\n- **Filename:** lowercase kebab-case from product name (\"Quill AI\" → `quill-ai.html`). Use `scripts/kebab_slug_generator.py` for deterministic slug generation + duplicate detection.\r\n- **Self-contained:** all CSS in `<style>`, all JS in `<script>`, only Google Fonts + GSAP CDN external.\r\n\r\n## Validation (Post-Generation)\r\n\r\nRun `scripts/html_validator.py --file ${OUTPUT_DIR}/<slug>.html` after generation. Checks:\r\n\r\n- All 3 required sections present (`.hero`, `.features`, `.closing-cta`)\r\n- CDN deps present (Inter + GSAP + ScrollTrigger)\r\n- `gsap.set()` initial states precede any `gsap.timeline` or `gsap.to` (FOUC prevention)\r\n- Responsive breakpoints at 900px + 580px\r\n- No external `<link rel=\"stylesheet\">` other than Google Fonts\r\n- No external `<script src=>` other than GSAP CDN\r\n- `<meta name=\"viewport\">` present\r\n- All animated elements have initial-state declarations\r\n\r\n## Error Handling\r\n\r\n| Situation | Behavior |\r\n|---|---|\r\n| Input is just a name with no context | Invent compelling content from name semantics + audience register; flag as `<!-- inferred -->` in HTML source |\r\n| Input file is large or PDF | Read fully before generating; don't truncate |\r\n| Brand colors insufficient (only 1 HEX provided) | Use as primary; derive secondary/accent algorithmically (lighten/darken via brand_palette_validator.py) |\r\n| Features count not specified | Default to 4 |\r\n| Output dir doesn't exist | Create it |\r\n| Existing file at output path | Append timestamp suffix or ask user (kebab_slug_generator.py flags duplicates) |\r\n| html_validator returns FAIL | Regenerate ONLY the failing sections in one targeted pass; do NOT abandon the file |\r\n\r\n## Portability\r\n\r\n- **Claude Code CLI:** Native — writes HTML file directly to filesystem.\r\n- **Claude.ai web:** Native — produces HTML as an artifact instead of file.\r\n\r\n## Tooling\r\n\r\n| Script | Role |\r\n|---|---|\r\n| `scripts/brand_palette_validator.py` | Validates HEX format, checks WCAG AA contrast, generates derived palette from primary (algorithmic lighten/darken). |\r\n| `scripts/kebab_slug_generator.py` | Product name → kebab-case filename + duplicate detection in output dir. |\r\n| `scripts/html_validator.py` | Post-generation structural check: 3 sections, CDN deps, gsap.set() initial states, responsive breakpoints, no external files. |\r\n\r\n## References\r\n\r\n- [`references/brand_system_design.md`](references/brand_system_design.md) — color theory + WCAG + algorithmic palette derivation (7+ sources)\r\n- [`references/gsap_animation_patterns.md`](references/gsap_animation_patterns.md) — entrance timeline + ScrollTrigger reveals + mouse parallax + CSS floats + scroll indicator (7+ sources)\r\n- [`references/single_file_html_discipline.md`](references/single_file_html_discipline.md) — why inline + CDN-only externals + accessibility minimums + no-build rationale (7+ sources)\r\n\r\n## Anti-Patterns To Reject\r\n\r\n- Hardcoded absolute paths in output directory\r\n- Single brand palette without override documentation\r\n- Outlining before writing — write in one pass\r\n- External CSS or JS files (must be inline; only Google Fonts + GSAP CDN allowed)\r\n- Skipping `gsap.set()` initial states (causes FOUC)\r\n- More than 6 features in default grid (becomes unscannable)\r\n- Brand-specific content references in the skill itself\r\n\r\n---\r\n\r\n**Version:** 1.0.0\r\n**Source spec:** `megaprompts/04-landing-megaprompt.md` (maintainer-local draft spec — gitignored, not present in the public repository)\r\n**Build pattern:** Path B (direct conversion). Distinct from `product-team/skills/landing-page-generator/`."
  user_template: ""
variables: []
install:
  steps:
    - title: Download & unzip
      detail: >-
        Download the .zip package from SkillVault and unzip it. The landing/ folder contains
        SKILL.md plus any companion scripts, references and assets.
    - title: Copy into your agent skills directory
      detail: >-
        Move the folder into your agent's skills directory — e.g. ~/.claude/skills/ (Claude Code),
        .codex/skills/, .cursor/skills/ or your project's .claude/skills/ folder — then restart or
        reload the session.
    - title: Use it
      detail: >-
        Describe the task in natural language; the agent loads the skill automatically when the
        request matches the skill description.
usage:
  steps: []
metadata:
  author: SkillVault
  source: https://skillvault.top/skills/landing
  exported_at: "2026-11-03T07:43:57.598Z"