web-copy
Skill0 starsChanged 3 months agoMITView on GitHub
Review or draft website copy at the level of a senior copywriter in a digital agency - clear, persuasive, friendly, SEO-sound, in European English (en-GB). Use when the user wants to improve, rewrite, polish, audit, or draft copy for a landing page, hero, pricing page, about page, feature page, product page, blog post, meta title/description, CTA, or microcopy. Enforces plain-English clarity, en-GB spelling and tone, on-page SEO rules, conversion frameworks (AIDA, PAS, StoryBrand, Before-After-Bridge, Schwartz's stages of awareness), and Cialdini-grade persuasion. Two modes - review-mode critiques and rewrites existing copy against a rubric, draft-mode writes new copy from a brief.
In this repository8 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- skill-makerSkill
- web-accessibilitySkill
- web-colorSkill
- web-componentsSkill
- web-motionSkill
- web-typographySkill
The file
We split this skill into the rules it gives an agent
11 rules. About 0 are common, 5 are distinctive, and 6 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
6
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 23
Default tone is professional-friendly (Mailchimp / Shopify Polaris territory).
- Distinctive: line 34
If the user pasted or pointed at existing copy → review.
- Distinctive: line 35
If the user described a page they want written → draft.
- Distinctive: line 36
If ambiguous, ask once.
- Very specific: line 43
Read references/rubric.md before scoring or writing anything.
- Very specific: line 80
Use the layout in assets/before-after.md as the template.
- Distinctive: line 94
If the brief is missing something critical (audience, primary action, offer, brand voice), ask once, list the missing items together, then …
- Very specific: line 98
Use the layout in assets/brief-template.md for what a good brief contains.
- Very specific: line 119
Voice authenticity check: Before returning any draft or rewrite, scan against every pattern in references/llm-fingerprints.md.
- Very specific: line 142
Every finding in the table maps to a rubric line in references/rubric.md.
- Distinctive: line 148
Every superlative is backed or removed.
≈ “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.
Files
Web Copy
Improves or drafts website copy that reads like it came from a senior copywriter in a digital agency: clear, persuasive, friendly, SEO-sound, in European English.
Two modes, one rubric:
- Review — the user pastes copy (or a URL or a file path). Score against the rubric, mark up issues, return a clean rewrite.
- Draft — the user gives a brief. Pick a framework, draft the page, then self-check against the same rubric before returning.
Default tone is professional-friendly (Mailchimp / Shopify Polaris territory).
Override with a tone: line in the brief if the user wants formal or playful.
Language default is en-GB. Never emit -ize spellings, color, favorite,
gotten, awesome, reach out, single-word Americanisms, or the Oxford comma
(unless it removes real ambiguity).
Process
1. Decide the mode
If the user pasted or pointed at existing copy → review. If the user described a page they want written → draft. If ambiguous, ask once.
For a URL, fetch it with the built-in WebFetch tool and pull the visible copy
before scoring. For a file path, Read it.
2. Load the rubric
Read references/rubric.md before scoring or writing anything. Every finding,
every rewrite decision, has to map to a rubric line. This is the anchor that
keeps output consistent between runs.
Load these on demand — do not load them upfront:
references/european-english.md— every run (en-GB is the default).references/seo-checklist.md— for any page that will be indexed.references/frameworks.md— before drafting or when a rewrite needs a structural fix, not a line-level fix.references/microcopy.md— for buttons, forms, errors, empty states, 404s.references/page-patterns.md— when the brief is "hero", "pricing", "about", "features", "FAQ", "testimonials", or "footer".references/authors.md— when justifying a specific move (cite the author the rule comes from, e.g. Schwartz on awareness, Sugarman on the slippery slide, Ogilvy on headlines). Adds credibility, keeps the skill from inventing rules.references/sources.md— when the user asks why a rule exists or wants further reading.references/llm-fingerprints.md— every draft and every review, not optional. Enforcement backbone for category 9 (voice authenticity).
3. Review mode — the output shape
Return in this order, in one message:
- Verdict — one sentence. What's the biggest problem, or what's working.
- Findings table — Markdown table with columns: Location (which sentence / heading / CTA), Issue (rubric category), Severity (high / medium / low), Suggested rewrite.
- Clean rewrite — the full copy, rewritten, ready to paste. No commentary inside the rewrite.
- SEO block — proposed
<title>(≤ 60 chars), meta description (≤ 155 chars), suggested H1, target keyword, and any internal-link opportunities you spotted. - What I did not change and why — anything the user might expect to have been touched but wasn't (e.g. a legally required disclaimer).
Use the layout in assets/before-after.md as the template.
4. Draft mode — the output shape
- Chosen framework — one line. "Using PAS because the audience is problem-aware but not solution-aware (Schwartz stage 2)." If no framework fits, say so and write plainly.
- The draft — the full page copy, with headings marked (H1/H2/H3), body paragraphs, CTAs, and any microcopy the page needs.
- SEO block — same fields as review mode.
- Self-check — a two-line pass confirming en-GB, one H1, tone, active-voice
ratio, no unverifiable superlatives, and no LLM fingerprints (see
references/llm-fingerprints.md).
If the brief is missing something critical (audience, primary action, offer, brand voice), ask once, list the missing items together, then proceed with sensible defaults if the user says "your call".
Use the layout in assets/brief-template.md for what a good brief contains.
5. Always-on rules
- One H1 per page. More than one is an SEO bug, not a style choice.
- Benefits before features. Lead every section with what the reader gets, not what the product does.
- Specific numbers over vague claims. "Cut invoice time from 40 minutes to 4" beats "save time".
- No unverifiable superlatives (
best,world-class,leading) unless the user supplies proof. If they do, cite it inline. - No stock openers. No "In today's fast-paced world", no "We are excited to announce", no "Welcome to our website".
- Active voice ≥ 80%. Passive is fine when the agent is genuinely unknown or unimportant.
- Contractions on for professional-friendly. Off for formal.
- Exclamation marks off unless the user's brand voice explicitly wants them.
- CTAs are verb-led (
Get my quote,Start free,See the demo). NotSubmit,Click here, orLearn more. - One primary CTA per section. Secondary CTAs may exist but must not compete for weight.
- Voice authenticity check. Before returning any draft or rewrite, scan
against every pattern in
references/llm-fingerprints.md. Every fingerprint is a fail — fix in place, don't ship.
Edge cases
- User pasted non-copy (code, JSON, a brief instead of the copy) — ask which mode they want.
- User asked for US English — honour it, but flag once that the skill defaults to en-GB.
- User asked for another language — say the skill is en-GB only; offer to do the strategic review (rubric, structure, SEO) and leave the language version to them.
- Legal, medical, financial claims — do not soften or invent them. Flag any claim that reads as regulated and ask the user to confirm the source.
- User's brand voice already exists (style guide, tone doc) — read it, defer to it wherever it conflicts with the skill's defaults, and say so in the verdict line.
- Very short copy (a single CTA, a headline) — skip the findings table; return the rewrite plus one line of rationale.
Checks before finishing
- Every finding in the table maps to a rubric line in
references/rubric.md. - The clean rewrite is self-contained — a reader could paste it into the page without editing.
- SEO block is present for any page-length rewrite (title, meta, H1, keyword).
- en-GB check has been run: no
-ize, nocolor, nofavorite, no Americanisms. - One H1 in the rewrite. Not zero, not two.
- Every superlative is backed or removed.
- Voice-authenticity scan run: em-dashes ≤ 1 per 100 words, no double-"I"
clauses without a third repetition, no AI-slop vocabulary
(
supercharged,AI-powered,harnessing AI, etc.), no "As an X" openers, no "In conclusion" closers, no X-not-Y aphoristic paragraph closers. Full list inreferences/llm-fingerprints.md.
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
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.

