agentleFS
DeupaxxDeupaxx/EveryDay-Writer/skills/web-copy/SKILL.md

web-copy

Skill39 starsChanged 56 days agoMITView on GitHub

Write website copy, landing pages, and homepage writing that converts without lying. Use for hero sections, feature pages, about pages, and product marketing copy. Enforces the EW anti-AI rules, specificity standards, and the writer's voice profile.

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:

    Every claim on a website is a bet.

    line 92
  2. Distinctive:

    After every benefit claim, ask: where's the proof?

    line 95
  3. Distinctive:

    Every visitor who doesn't convert has an objection.

    line 125
  4. Very specific:

    After producing any draft, stop.

    line 157

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 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

EW Skill — Web Copy

Dependency chain. Read these in order before writing anything:

  1. core/runtime-contract.md (short operating contract; does not replace the full rules)
  2. core/obsidian-workspace.md (resolve storage and persistence rules)
  3. core/anti-ai-rules.md (full standard)
  4. core/ai_slop_commandments.md (mechanism reference and diagnostic checklist)
  5. core/voice-profile.md (voice resolver; require the resolved profile's Completed: field to be exactly Yes, otherwise stop and run onboarding)
  6. Any .md files in the active voice's references folder, as resolved by core/voice-profile.md

This chain applies on direct invocation (/ew:web-copy) exactly as it does on dispatch through /ew. Direct invocation skips routing, not constraints.


WHAT THIS SKILL IS FOR

Website copy, landing pages, and homepage writing. Copy that converts visitors into readers, signups, or buyers — without lying, manipulating, or sounding like a SaaS onboarding wizard wrote it.

Web copy has one job: get the right person to take the right action. Everything else is decoration.


THE HIERARCHY OF A PAGE

Web readers do not read — they scan. They enter a page with a question: "Is this for me, and is it worth my time?" Your copy has roughly 5 seconds to answer yes before they leave.

The hierarchy:

1. Headline: The single most important sentence on the page. It must state the specific benefit or outcome in plain language. Not a clever tagline — a direct claim.

❌ "Redefining the future of content creation." ✅ "Newsletter templates that don't sound like every other newsletter."

2. Subheadline: Supports the headline by adding one layer of specificity. What exactly does the product/service do, for whom?

3. Above-the-fold body: 2–3 sentences maximum. Confirms the reader is in the right place. Addresses their most immediate concern or question.

4. Social proof: Specific, named, and placed near the claim it supports — not dumped at the bottom of the page.

5. CTA: One action per section. Clear, specific, low-friction language.

Below the fold: Everything that earns the skeptic. Features, how it works, more proof, objection handling, FAQ.


HEADLINE RULES

The headline must contain a specific benefit or outcome. Test every headline with this question: could this headline appear on a competitor's site without being wrong? If yes, it's too generic.

Specificity ladder:

  • Generic: "Better writing tools"
  • Better: "Writing tools for independent creators"
  • Good: "Ship your newsletter in half the time without sounding like AI wrote it"

The more specific the claim, the more it will resonate with the right reader — and the more it will filter out the wrong ones. Filtering is not a failure; it's precision.

The benefit, not the feature: Features are what it does. Benefits are what changes for the reader. Feature: "AI-powered grammar check" Benefit: "Write without stopping to fix every sentence"

Lead with the benefit. Explain the feature as the mechanism.


TONE: DIRECT, NOT CASUAL

Web copy fails in two directions: corporate stiffness and faux-casual overreach. Both are forms of not trusting the product to speak for itself.

Corporate stiffness: "Our comprehensive suite of integrated solutions empowers teams to achieve synergistic outcomes at scale." Nobody speaks this way. Nobody trusts it when they read it.

Faux-casual overreach: "Hey there! We know how much it sucks when your content just... doesn't land. We've been there too. That's why we built this for you, friend." Forced intimacy is worse than formality.

Direct: "This does X. It works because Y. Here's what happens when you use it." The reader is an adult. Write to them as one.


SPECIFICITY AND PROOF

Every claim on a website is a bet. You're betting the reader will believe it. Vague claims pay out nothing. Specific claims build trust.

The proof test: After every benefit claim, ask: where's the proof? If you can't point to a number, a named example, a specific mechanism, or a testimonial from a real person — the claim is a gesture, not an argument.

❌ "Thousands of writers use this every day." ✅ "Used by 4,200 independent newsletter writers, including [Name] ([Newsletter])."

Named testimonials only. "John D., Entrepreneur" is not a testimonial. "Maya Rodriguez, who writes [Newsletter Name] for 12,000 subscribers" is a testimonial. Unnamed quotes read as invented. Named quotes read as real.


CTA ARCHITECTURE

One CTA per section. The action must be specific and the friction must be named honestly.

Bad CTAs:

  • "Learn more" (learn more about what? How much more?)
  • "Get started" (started with what? What does that involve?)
  • "Join the community" (what community? What does joining require?)

Good CTAs:

  • "Start your free 14-day trial — no credit card required"
  • "Download the template (PDF, 2 pages)"
  • "Subscribe — one email per week, unsubscribe anytime"

The CTA must answer: what am I doing, what do I get, and what does it cost me? If any of those are unclear, the CTA is doing less than it could.


OBJECTION HANDLING

Every visitor who doesn't convert has an objection. Your copy's job is to anticipate and address the most common three before the reader has to ask.

Common objections:

  • "Is this for someone like me?" — Address with specific audience language early
  • "Is this worth the cost?" — Address with specific ROI or comparison
  • "Can I trust this?" — Address with named proof, specifics, and honest limitation statements

Honest limitation statements build trust: "This works best for solo writers and small teams. If you're managing a content operation with 50+ people, you'll want something more enterprise-scale."

Acknowledging what you're not for makes the reader trust what you claim you are for.


MICROCOPY

The small copy — button labels, form field hints, error messages, confirmation text — is where brand voice either shows up or disappears.

Button labels: Describe the action from the user's perspective. ❌ "Submit" → ✅ "Send my application" ❌ "Click here" → ✅ "See the full breakdown"

Form field hints: Tell the reader exactly what format you want and why. "Email address — we'll only use this for your account and weekly digest."

Error messages: State what went wrong and what to do, without blaming the user. ❌ "Invalid input" → ✅ "That email format doesn't look right — check for spaces or typos."


POST-GENERATION REVIEW

After producing any draft, stop. Re-read core/anti-ai-rules.md Sections 1–7 with the draft in front of you. Go line by line through the pre-publish checklist in Section 7. Fix every failure before presenting the output.

Web copy lives on a page permanently. A banned word or AI-patterned sentence in a headline is read by every visitor. Fix it before it ships.

PRE-LAUNCH CHECKLIST

  • Does the headline state a specific benefit, not a clever tagline?
  • Is the subheadline more specific than the headline?
  • Is the reader's primary question answered above the fold?
  • Does every benefit claim have specific proof?
  • Are all testimonials named and specific?
  • Is each CTA clear about what action, what outcome, and what cost?
  • Are the top 3 objections addressed before the reader has to ask?
  • Have you run Sections 1–7 of core/anti-ai-rules.md?
  • Is the tone direct — neither corporate nor fake-casual?
  • Does the microcopy reflect the same voice as the rest of the page?

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.