agentleFS
leo-scostaleo-scosta/skillset/skills/web-copy/SKILL.md

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.

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
  1. Very specific:

    Default tone is professional-friendly (Mailchimp / Shopify Polaris territory).

    line 23
  2. Distinctive:

    If the user pasted or pointed at existing copy → review.

    line 34
  3. Distinctive:

    If the user described a page they want written → draft.

    line 35
  4. Distinctive:

    If ambiguous, ask once.

    line 36
  5. Very specific:

    Read references/rubric.md before scoring or writing anything.

    line 43
  6. Very specific:

    Use the layout in assets/before-after.md as the template.

    line 80
  7. Distinctive:

    If the brief is missing something critical (audience, primary action, offer, brand voice), ask once, list the missing items together, then …

    line 94
  8. Very specific:

    Use the layout in assets/brief-template.md for what a good brief contains.

    line 98
  9. Very specific:

    Voice authenticity check: Before returning any draft or rewrite, scan against every pattern in references/llm-fingerprints.md.

    line 119
  10. Very specific:

    Every finding in the table maps to a rubric line in references/rubric.md.

    line 142
  11. Distinctive:

    Every superlative is backed or removed.

    line 148

≈ “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

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:

  1. Verdict — one sentence. What's the biggest problem, or what's working.
  2. Findings table — Markdown table with columns: Location (which sentence / heading / CTA), Issue (rubric category), Severity (high / medium / low), Suggested rewrite.
  3. Clean rewrite — the full copy, rewritten, ready to paste. No commentary inside the rewrite.
  4. SEO block — proposed <title> (≤ 60 chars), meta description (≤ 155 chars), suggested H1, target keyword, and any internal-link opportunities you spotted.
  5. 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

  1. 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.
  2. The draft — the full page copy, with headings marked (H1/H2/H3), body paragraphs, CTAs, and any microcopy the page needs.
  3. SEO block — same fields as review mode.
  4. 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). Not Submit, Click here, or Learn 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, no color, no favorite, 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 in references/llm-fingerprints.md.

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.