Communitygithub.com

landing-qa

Shows an agent how to art-direct and build "landing qa" so the concrete output is a landing page, homepage, or portfolio. The procedure moves through Landing QA, Inputs, Steps. Use it when a new assignment calls for this craft.

landing-qa 是什么?

landing-qa is a Claude Code agent skill that shows an agent how to art-direct and build "landing qa" so the concrete output is a landing page, homepage, or portfolio. The procedure moves through Landing QA, Inputs, Steps. Use it when a new assignment calls for this craft.

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mavrin-xv/landing-factory/tree/HEAD/skills/landing-qa

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Landing QA

Catch the broken things before the owner does. Scripts find the wiring faults; the slices make a person look at every part of the page at both widths.

Inputs

  • The site folder and the page file(s).
  • gates.json for this round (start from templates/gates.json): required counts, banned strings, stylesheets, classes added this round.
  • The facts file and the clicked promise, for the copy and first-screen checks.

Steps

  1. Screenshots and runtime checks. python3 scripts/shot.py <site> index.html <out> --overflow. It reports scrollWidth, console errors, failed requests and blank images per width, and saves full pages and slices.
  2. Wiring gate. python3 scripts/gates.py <site>/index.html gates.json. Anchors, local files, one H1, viewport, counts (every CTA wired to the offer), banned strings, class collisions.
  3. Copy, design and first screen. Run ../landing-copy/scripts/copy_lint.py, ../landing-design/scripts/design_lint.py and ../first-screen-check/scripts/first_screen.py.
  4. Read every slice, 390 first, with references/qa-checklist.md open.
  5. Fix and rerun until all green. A fix that touches another block means the whole set runs again.
  6. Report the outputs, the slices read, and the placeholders still owed.

Gates

  • shot.py exits 0 at both widths.
  • gates.py exits 0.
  • copy_lint, design_lint and first_screen green.
  • Every slice read; the by-eye list in references/qa-checklist.md ticked.

Output

index.html 1440px  scrollWidth 1440 OK  errors 0  blank images 0  PASS
index.html 390px  scrollWidth 390 OK  errors 0  blank images 0  PASS
index.html 1440px: 3 slices, read every one
index.html 390px: 2 slices, read every one
shot: all green
gates: all green (1 anchors, 2 local files, 2 counts, 4 zero rules)

Example outputs: examples/northwind-roasters/out/shot.txt, examples/northwind-roasters/out/gates.txt, config examples/northwind-roasters/gates.json.

Failure modes

TrapWhat it looks likeInstead
Green scripts, broken lookan empty grid cell nobody sawread every slice at both widths
Overflow at 390 onlythe page scrolls sideways on phones--overflow lists the element; fix its width or min-width
CTA rewired by an editone button now points at #plans, which no longer existscounts in gates.json pins every CTA
Class collisiona new block styled by an old stylesheet's rulelist new classes in classes; prefix per block
Blank lazy imagesthe full-page screenshot has a white herono lazy loading above the fold; the script scrolls but cannot fix it
Leftover stringsthe reference's brand name in alt textzero in gates.json lists it
Gates run on the wrong filethe build wrote page-v3.html, gates checked index.htmlone path per round, the same in the build script and the gates

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

cro-audit

Shows an agent how to art-direct and build "cro audit" so the concrete output is a landing page, homepage, or portfolio. The procedure moves through CRO audit, Inputs, Steps. Use it when a new assignment calls for this craft.

landing-copy

Design skill. Writes and checks the words of a one-offer landing page. It turns the offer into a hero with the outcome and the cost, a mechanism, segments, proof and an honest offer block in skeptic order, then lints the copy for dashes, hype, fake urgency, income promises and numbers missing from the facts file, and scores it on a 7-dimension gate. Use when writing or rewriting landing page copy, when the user says "write the copy", "the hero is weak", "nobody understands what we sell", "check this copy", or

landing-design

Design skill. Designs and builds the HTML and CSS of a landing page that does not look generated. It commits to one written design read, sets tokens with one accent and an off-black ink, builds mobile first at 390, gives every section a visual, sizes grids to the content, and lints the result for the tells of a template page. Use when building or restyling a landing page, when the user says "make it look less AI", "it looks like a template", "design the sections", "fix the mobile layout", or after the copy fo

landing-factory

Design skill. Builds a converting landing page from a reference URL and a brief, in rounds. It reverses the reference, writes the page architecture, applies a design canon and a copy canon, builds mobile first, and runs the gates (copy lint, design lint, wiring, screenshots, first screen, copy score, CRO score) before every round is shown. Use when the user asks to "make a landing page like this one", "build a sales page", "clone this site for my product", "redo our landing", "fix the landing after feedback",

相关技能