agentleFS
ravidsrkravidsrk/agent-skills/skills/landing-page-craft/SKILL.md

landing-page-craft

Skill1 starsChanged 24 days agoMITView on GitHub

Audit any landing page for default-template design patterns, AI-slop copy, DESIGN.md drift, and answer-engine readiness, then produce a deterministic fix plan. Use when the user asks "does this look AI-generated?", "audit my landing page", "slop score", "why does this site look generic?", "can ChatGPT cite my site?", or wants a marketing page reviewed before launch.

  • Sends data out

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

4 rules. About 0 are common, 3 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Before launching or redesigning a marketing page

    line 30
  2. Distinctive:

    After a hero rewrite that still feels flat

    line 31
  3. Very specific:

    If no scanner is available, use the manual rubric in references/design-patterns.md and references/copy-patterns.md.

    line 104
  4. Distinctive:

    If the project declares a design system, the scanner compares the live DOM against it:

    line 181

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Landing Page Craft

Score a landing page the way a skeptical design reviewer would: what makes it look like every other AI-generated page, what makes the copy sound synthetic, whether it honors its own design system, and whether answer engines can read it. Then fix the highest-impact issues first.

The scoring engine is slop-detect. Its pattern catalogue is versioned; this skill carries the workflow, the output contract, and the fix playbook.

When to use

  • "Audit my landing page" / "review my landing page"
  • "Does this look AI-generated?" / "why does this look generic?"
  • "Slop score" / "design slop" / "template tells"
  • "Does my site honor its DESIGN.md?"
  • "Can ChatGPT / Claude / Perplexity read and cite my site?"
  • Before launching or redesigning a marketing page
  • After a hero rewrite that still feels flat

When NOT to use

  • App UI behind auth. The scanner needs a reachable page.
  • Pure copy editing with no design or AEO question — use a copy review.
  • A page that is intentionally a template or a wireframe.
  • You need a full UX research study; this is a pattern audit, not user research.

Inputs

InputRequiredNotes
Page URLyesPublic URL, or localhost with the local CLI
DESIGN.md or DTCG tokens.jsonoptionalEnables the system-compliance axis
Target tieroptionalClean for a strict bar, Mild for a first pass
Audience / categoryoptionalUsed to judge whether the H1 is concrete

What gets scored

Four independent axes plus a craft floor:

AxisWhat it measuresBetter direction
Design slop45 CSS/DOM patterns associated with default-template outputlower
Copy slop26 prose patterns associated with synthetic marketing copylower
System complianceWhether the live DOM honors the page's declared DESIGN.md / tokens (9 checks)higher
AEO readinessWhether crawlers and answer engines can fetch, index, and cite the page (16 checks)higher
Craft floor11 baseline craft checks, reported separatelyhigher

The design and copy scores never blend. A page can be visually clean and copy-sloppy, or vice versa.

Scoring tiers

AxisCleanMildHeavy
Design0–910–27≥28
Copy0–78–19≥20
SystemAligned ≥80Drifting 50–79Off-system <50
AEOEligible ≥80Partially eligible 50–79Restricted <50

Weight-0 rules are listed in the catalogue but do not add points until they are promoted. Do not invent scores for them.

The workflow

Step 1 — Scan

Hosted API (fastest, no install):

bash scripts/scan.sh https://example.com --design --aeo

Equivalent raw call:

curl -s -X POST https://slop-detect.com/api/scan \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com","axes":["design","copy"],"designMd":true}' | jq .

Localhost or a private page:

npx -y slop-detect http://localhost:3000 --copy --craft --design-md auto

MCP host:

scan_page → check_aeo → check_design_system → fix_prompt

If no scanner is available, use the manual rubric in references/design-patterns.md and references/copy-patterns.md. Read the page source and the rendered hero, not just a screenshot.

Step 2 — Read the evidence, not just the score

For every triggered pattern, collect:

  • the pattern ID and weight
  • the literal DOM/CSS or copy evidence (selector, line, text)
  • whether the rule is active, decaying, review, or retired

A score without evidence is not actionable. If the scanner returns only a number, inspect the page yourself and map the strongest tells to the catalogue.

Step 3 — Report

Use this shape:

# Landing Page Audit: {project}

**URL:** {url}
**Audited:** {YYYY-MM-DD}
**Design slop:** {n}/… {tier}
**Copy slop:** {n}/… {tier}
**System:** {Aligned|Drifting|Off-system} ({score}/100)
**AEO:** {Eligible|Partially eligible|Restricted} ({score}/100)
**Craft floor:** {score}/100

## 🔴 Triggered patterns
- `pattern_id` (weight N) — {evidence}. Fix: {one concrete change}.

## 🟢 What works
- {specific, cited observation}

## 🎯 Single highest-impact fix
{One change with the exact replacement copy or CSS.}

## Fix order
1. ...
2. ...
3. ...

Step 4 — Fix in impact order

For most pages:

  1. Rewrite the H1 as [Category] for [audience]. This alone fixes several copy patterns and clarifies the page.
  2. Remove the fake-news eyebrow (sparkle pill, "AI-powered", "now in beta" with no real news).
  3. Replace "Sign up" / "Get started" with a verb + outcome CTA.
  4. Remove the gradient/glow/glass stack and pick one accent on a flat surface.
  5. Replace the three-icon card trio with one product-narrative section (code switcher, transcript, terminal, workflow loop, real screenshot).
  6. Reduce motion to one purposeful animation or none.
  7. Add a custom OG image and verify the meta tags.
  8. Fix AEO blockers (server-rendered text, robots, llms.txt, markdown twin).
  9. Re-scan and compare axis by axis.

See references/fix-playbook.md for copy formulas and examples.

Step 5 — Re-scan

A fix is not done until the same pattern no longer triggers. Keep the before/after report in the PR or issue.

AEO checklist (summary)

The full 16-check list is in references/aeo.md. The required blockers are:

  • the HTML is reachable without JavaScript-only rendering
  • edge/CDN access is not blocked for the scanner
  • robots rules allow search indexing
  • the page is indexable (no noindex on the canonical URL)
  • AI preview controls are not blocking the page unintentionally
  • server text coverage is high enough to read the main content
  • a markdown twin, llms.txt, and rel=alternate are recommended, not required
  • structured data is valid, not decorative

DESIGN.md compliance

If the project declares a design system, the scanner compares the live DOM against it:

  • tokens and colors
  • type scale and line height
  • spacing and radius
  • shadow/elevation
  • component states
  • motion

A page can look fine and still be off-system. Report drift as a separate axis; do not fold it into the slop score.

Common gotchas

GotchaFix
Localhost scan failsUse the CLI/MCP local mode; the hosted API cannot reach your machine
Auth-gated page returns a login screenUse a preview URL with a test account or a local scan
Score is low but the page still feels genericCheck the weight-0 review rules and the craft floor; re-read the hero and section order
Copy is clean but the design is heavyFix the design axis; don't keep rewriting copy
Replacing one slop pattern with anotherRead the fix playbook; Inter → Geist, indigo → violet, gradient text → radial gradient are lateral moves
AEO score changes without a deployThe scanner uses its own user agent and network path; verify reachability from the same region

References

  • references/design-patterns.md — the 45 design patterns, weights, status
  • references/copy-patterns.md — the 26 copy patterns, weights
  • references/aeo.md — the 16 AEO checks and remediation
  • references/design-md.md — DESIGN.md / DTCG system compliance
  • references/fix-playbook.md — H1, CTA, OG, narrative, typography, motion
  • scripts/scan.sh — hosted API + CLI fallback wrapper

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.