Marketing Site Skill

Marketing Site Skill

Use this specialist for public-facing pages where the first viewport, product/place/person signal, conversion path, media quality, metadata, and responsive behavior matter.

Operating Modes

• build: create or refactor a marketing/public page.
• audit: review a page for conversion, metadata, responsive behavior, and visual clarity.
• metadata: inspect title, description, canonical, Open Graph, Twitter, headings, and social preview basics.
• verify: run local checks and distinguish evidence from manual review.

Required Workflow

1. Read references/hero-first-viewport.md before designing the top of the page.
2. Read references/conversion-framework.md for CTA and proof decisions.
3. Read references/metadata-checklist.md when source files or HTML are available.
4. Use assets/landing-brief.template.md and assets/metadata.template.json when producing durable page briefs or metadata specs.
5. Apply ../../shared/privacy-policy.md before using external images, AI page builders, or cloud tools.
6. If source files are available, run scripts/lint_metadata.py or report why it was skipped.
7. If a URL is available, run scripts/responsive_smoke_test.mjs or report why it was skipped.
8. Return Ran, Skipped, Planned, and Manual sections.

Design Doctrine

• The first viewport must show the product, place, offer, brand, object, or person clearly.
• Do not hide the real subject inside a decorative card or generic gradient.
• Use real or generated bitmap media when a visual signal is needed.
• Keep CTA hierarchy obvious and avoid many visually equal primary actions.
• Keep mobile text readable and avoid overlap, horizontal overflow, and viewport-scaled font tricks.

Tool Contracts

• Metadata lint: python3 scripts/lint_metadata.py --root "$PROJECT_ROOT" --out reports/metadata.json.
• Responsive smoke: node scripts/responsive_smoke_test.mjs --url "$URL" --out reports/visual-smoke.
• Optional cloud tools require explicit approval and cannot be validation evidence by themselves.

Validation

python3 $CODEX_SKILLS_DIR/.system/skill-creator/scripts/quick_validate.py $CODEX_SKILLS_DIR/marketing-site-skill
python3 $CODEX_SKILLS_DIR/senior-skill-architect/scripts/lint_production_skill.py $CODEX_SKILLS_DIR/marketing-site-skill

Output Shape

Page type:
Primary offer or object:
First viewport:
CTA path:
Metadata:
Ran:
Skipped:
Manual findings:
Risks: