handley-everybody-writes ยท diff
git:20261002.46ac0a1 to git:20261002.d5668a9
24 added, 96 removed. Audit A to A.
---
name: handley-everybody-writes
- description: "Draft and revise reader-centered marketing writing using Ann Handley's public Everybody Writes method. Use for emails, articles, landing pages, brand stories, and copy that needs clearer purpose, useful detail, and a distinctive voice."
+ description: "Draft and revise reader-centered marketing writing using Ann Handley's public method. Use for emails, articles, landing pages, brand stories, and microcopy that need a clear purpose, useful evidence, and a distinctive voice."
---
# Everybody Writes in Practice
+
Based on Ann Handley's public method. Not affiliated with or endorsed by Ann Handley.
## When to use
- Use this skill to turn a brief, notes, or an existing draft into useful marketing writing for a particular reader. It applies to substantial articles and small pieces such as subscription confirmations, FAQs, and product descriptions. Treat those smaller surfaces as opportunities to express the same recognizable brand voice. [S1] [S4]
-
- This procedure adapts Handley's public guidance for an agent. It is not a reproduction of her book. Apply her judgment to the user's actual format and constraints rather than forcing every assignment into an article or a personal anecdote. Her method allows different ways of writing while insisting that revision serves the reader. [S2]
-
- ## Operational procedure
-
- ### 1. Define the business purpose before composing
-
- Write a working sentence identifying what this piece should accomplish for the business and how it connects to the larger marketing goal. Replace a vague assignment such as producing a post with a specific intended result, such as helping a qualified buyer evaluate an offer. Keep that purpose visible while drafting so interesting tangents do not quietly replace the assignment. [S1]
-
- For an agent-assisted task, establish where the human's thinking enters the work. Use their notes, lived details, point of view, or existing draft as the starting material. Handley warns that routinely outsourcing first drafts can displace the very thinking that makes writing distinctive. If asked to draft from scratch, proceed from the supplied brief, mark missing personal details as gaps, and describe the result as a proposed draft rather than the author's experience. This is an agent adaptation of that warning. [S7]
-
- ### 2. Reframe the goal around the reader
-
- Interrogate the business goal with the question "So what?" Answer in terms of why it matters to the intended reader, then interrogate that answer again. Continue until another answer would become circular, implausible, or too abstract to guide the copy. Capture the strongest reader consequence as one plain sentence at the top of the working draft. [S1] [S3]
-
- Distinguish a feature, its practical consequence, and its human significance. A collaboration feature might reduce version confusion, which might help a team deliver without a stressful last-minute scramble. Choose the level that this audience will recognize. Avoid a chain that leaps from a minor feature to guaranteed career success; the exercise finds meaningful stakes, not permission to inflate the promise. [S3]
-
- ### 3. Gather support before adding persuasion
-
- Collect credible data, relevant examples, and firsthand material that support the reframed idea. Match each important assertion to available evidence. When the writer's own experience is relevant, use it as an example without implying that one experience proves a universal outcome. If support is absent, narrow the assertion or flag the missing evidence in working notes. [S1]
-
- For customer stories, look for what customers have actually done or contributed. If existing customer material is appropriate, identify the attribution and permission needed before republication. Do not invent a customer quote to make the draft feel human. Handley's customer-as-hero approach includes recognizing real contributions and securing permission to reuse them. [S5]
-
- ### 4. Choose a structure that delivers the idea
-
- Select the form that most clearly communicates the point within the requested deliverable: an explanation for understanding, a how-to for action, or a case study for demonstrating a change. Arrange the supporting material around the reader's need rather than the order in which the business supplied its talking points. Build an outline before polishing sentences. [S1]
-
- When the piece needs a story, test for three discoveries: what the reader learns about the writer, what the reader recognizes about themselves, and what new idea becomes clear. Balance them. Excessive autobiography makes the story self-absorbed; excessive reader flattery feels manufactured; an idea explained without an illuminating story can turn into a lecture. Apply this test to narrative pieces, not mechanically to every interface label. [S6]
-
- ### 5. Write toward one identifiable person
-
- Picture the individual this piece helps, their situation, and the decision before them. Address that person directly where the brand voice permits. Replace detached descriptions of audiences with language that helps a person understand their own circumstances. Treat the customer as the one taking action and the product as something that helps them do it. [S1] [S3] [S5]
-
- Assume the reader may need the subject explained without treating them as unintelligent. Unpack a necessary idea in everyday language rather than burying it in insider vocabulary. For specialist readers, retain terminology when it conveys shared understanding or useful precision; remove it when it merely advertises expertise. Handley's later voice guidance qualifies her earlier hard line on jargon. [S2] [S4]
-
- ### 6. Produce a rough discovery draft
-
- Draft through the outline without stopping to repair every awkward sentence. The purpose of this pass is to uncover the thought and get the material onto the page. Allow incomplete transitions and placeholders in the working version, then resolve them during revision. A rough draft is a stage in producing strong work, not an excuse to deliver weak work. [S1] [S2]
-
- Preserve supplied human observations even when they are less tidy than stock marketing language. If the assignment is to revise an existing draft, diagnose it rather than replacing its point of view with a fluent generic version. Use assistance to question and develop the idea while keeping the author's original thinking available for judgment. [S7] [S8]
-
- ### 7. Create distance, then rewrite for the reader
-
- Separate drafting and revision into distinct passes. For a human writer, encourage a break when the schedule allows. An agent cannot reproduce that lived distance, but can revisit the draft against the reader's situation and the purpose sentence instead of continuing local sentence polishing. [S1]
-
- Rewrite for comprehension first. Move useful answers forward, explain missing connections, and remove passages that exist mainly because the writer enjoyed producing them. Evaluate whether a reader can understand the idea and its significance. A grammatically clean piece can still fail this test; editing means repairing clarity, not only correcting mechanics. [S1] [S2]
-
- ### 8. Make the voice identifiable
-
- Use the existing brand voice guide if available. Otherwise derive three specific voice attributes from the business's character, working style, and desired relationship with customers. Translate each attribute into actual sentence choices and a brief example. Avoid virtues almost any competitor would claim, such as basic reliability, as the entire definition of the voice. [S4]
-
- Set consistent pronouns for the business and reader. Identify which specialist terms clarify and which obscure. Then hide the company name mentally: could this copy belong unchanged to several competitors? If so, replace interchangeable phrasing with language that reflects the brand's particular perspective. Apply that test to supporting microcopy as well as the headline. [S4]
-
- ### 9. Give the headline its own revision pass
-
- After the body has a clear point, develop and compare headline or subject-line options. Give this pass serious attention rather than treating the title as a label attached at the end. Choose the option that best represents the reader-relevant idea actually delivered by the piece. A catchy title cannot rescue an unreframed business agenda. [S1] [S3]
-
- ### 10. Edit mechanics without draining the life
-
- Review grammar, usage, punctuation, and consistency after the substantive rewrite. Seek another editor when one is available; otherwise perform a separate editorial pass and identify unresolved factual or wording questions. Do not describe self-review as independent editorial approval. [S1] [S2]
-
- Read key sentences aloud or inspect their cadence. Preserve memorable phrasing, sound, and precise word choices when they strengthen the connection with the reader. Do not automatically flatten every unusual sentence into neutral corporate prose. Equally, do not import Handley's jokes into a brand whose own voice calls for a different register. [S4] [S8]
-
- ### 11. Check readability in the delivery format
-
- Inspect the piece as the reader will encounter it. Break dense passages into manageable paragraphs, add useful subheads, and use lists when they make information easier to scan. Preserve enough explanation for understanding; shortening everything mechanically can leave a clean-looking page with missing meaning. [S1] [S2]
-
- ### 12. Finish with a useful next action
-
- Answer what the reader should do after reading. Make the next step fit the purpose and what the piece has enabled them to understand. A conclusion that merely repeats the business's enthusiasm leaves the reader without direction. Preparing publication-ready copy is the endpoint of this writing procedure; actual publication follows the user's requested scope. [S1] [S3]
-
- Deliver the requested copy with its headline or subject line, supported reader benefit, coherent structure, recognizable voice, and appropriate next action. When material is missing, add a short note identifying unverified claims, experience placeholders, or reuse permissions instead of disguising those gaps inside finished prose. Include a compact rationale only when useful, naming the reader consequence and the most important revision decision. [S1] [S4] [S5] [S7]
-
- ## Worked example: invented illustration
-
- Scenario: A repair shop requests a booking email. Its supplied facts are that it services commuter bicycles and offers reservable weekday appointments. Its owner's note says customers often worry about losing their ride to work. There is no evidence supporting a same-day repair promise.
-
- The business goal is more weekday bookings. The questioning chain moves from appointment availability to less uncertainty about arranging a repair, then to planning a commute. The useful angle is planning around the bicycle's absence, not celebrating the shop's booking software. [S3]
+ Use this skill when turning a brief, notes, or an existing draft into marketing writing that helps a particular reader understand something or make a decision. It supports emails, articles, landing pages, customer stories, and smaller surfaces such as FAQs and subscription confirmations. Small surfaces deserve the same recognizable voice as prominent campaigns. [S1] [S4]
- A provisional voice uses practical, neighborhood-minded, and unhurried as attributes. Those become concrete language about the commute, a direct invitation, and no exaggerated urgency. The customer makes a plan; the shop helps. [S4] [S5]
+ The deliverable is the requested copy, with a title or subject line when appropriate, a useful next action, and concise review notes for unresolved evidence or permissions. Preserve the user's format, length, audience, and voice constraints. Do not turn every assignment into an article or personal story. The method is a revision framework, not a requirement to reproduce Handley's prose. [S2] [S6]
- Proposed copy:
+ Use the public method to guide judgment rather than claiming access to the book. Read the relevant sections of the method as each decision arises; consult the examples when the difference between fluent copy and useful copy is unclear. Source citations support these instructions, not an obligation to put method citations into customer-facing writing.
- Subject: Plan your bike repair around your commute
+ ## Procedure
- Your bike gets you to work. Booking its repair should help you plan the rest of the week.
+ 1. **Frame the assignment.** Record the business purpose, delivery surface, reader's situation, and desired decision in [the output template](templates/output-template.md). If revising, keep the author's central thought and distinctive observations available before changing sentences. Ask only for missing information that materially changes the result. [S1] [S7]
- Reserve a weekday service appointment and tell us what needs attention. If you need help arranging your commute while your bike is with us, ask about repair timing when you book.
+ 2. **Protect the human contribution.** Identify supplied experience, opinion, and evidence. Follow [the authorship rules](references/method.md#human-thinking-and-agent-assistance): work from those inputs, distinguish proposed language from real experience, and flag missing personal details. Handley's caution about AI first drafts should remain visible rather than being recast as an endorsement of automated authorship. [S7]
- Choose your weekday appointment.
+ 3. **Find the reader consequence.** Apply [the reframing test](references/method.md#purpose-and-reader-consequence) until the benefit is concrete and relevant. Record one guiding sentence. Stop before the chain becomes circular or speculative; a persuasive consequence must still fit the available facts. [S1] [S3]
- Review note: The draft avoids promising same-day completion. Confirm the actual booking link and how the shop discusses repair timing before publication. The reader receives a relevant benefit and an explicit next step without an unsupported turnaround claim. [S1] [S3]
+ 4. **Assemble support.** Use [the evidence rules](references/method.md#evidence-and-customer-contributions) to match claims to facts, examples, and authorized customer material. Narrow unsupported promises. Keep evidence gaps in working notes so they cannot accidentally become assertions in the final copy. [S1] [S5]
- ## Sources
+ 5. **Choose the structure.** Follow [the structure and story rules](references/method.md#structure-and-story) to arrange material around the reader's question. Use explanation, instructions, or a case story as needed. For narrative work, balance what it reveals about the writer, reader, and idea. [S1] [S6]
- [S1] Ann Handley, A Writing GPS: Step-by-Step Directions for Writing Your Next Piece of Content [Infographic]. Public article and its linked infographic fetched. https://annhandley.com/writing-gps-step-by-step-guide-to-creating-content-infographic/
+ 6. **Draft toward one person.** Use [the drafting rules](references/method.md#drafting-and-reader-revision) to write through the outline without premature polishing. Address the imagined reader directly when appropriate. Explain unfamiliar ideas without condescension; retain specialist vocabulary when it clarifies. [S1] [S2] [S4]
- [S2] Ann Handley, 13 Writing Rules. https://annhandley.com/13-writing-rules/
+ 7. **Rewrite for comprehension.** Revisit the purpose and reader situation in a separate pass using [the revision rules](references/method.md#drafting-and-reader-revision). Move useful answers forward, repair missing connections, and remove self-serving tangents. Review [the worked examples](examples/worked-examples.md) if the draft still centers the business. [S1] [S2]
- [S3] Ann Handley, The One Question Your Marketing Copy Should Answer. https://annhandley.com/how-to-write-marketing-copy/
+ 8. **Make voice specific.** Apply [the voice rules](references/method.md#voice-and-language). Follow an existing voice guide or propose three concrete attributes with sentence-level implications. Check pronouns, jargon, and small supporting text. Remove interchangeable marketing language while preserving expressive choices that serve the reader. [S4] [S8]
- [S4] Ann Handley, 5 Keys to Developing a Strong Tone of Voice in your Content Marketing. https://annhandley.com/5-keys-to-developing-a-strong-tone-of-voice/
+ 9. **Revise the headline separately.** Compare candidate titles or subject lines against [the headline rules](references/method.md#headline-editing-and-delivery). Choose one that accurately promises the benefit the body delivers. For tiny interface copy, use the actual label or message instead of adding an unnecessary title. [S1] [S3]
- [S5] Ann Handley, Make Your Customer the Hero of Your Story: 'The Fault in Our Stars' Video. https://annhandley.com/make-your-customer-the-hero-of-your-story/
+ 10. **Edit and inspect the surface.** Review mechanics, cadence, paragraphing, subheads, and scanability using [the review checklist](checklists/review-checklist.md). Seek another editor when available; label self-review honestly. Fix clarity failures before cosmetic polish and keep enough explanation for understanding. [S1] [S2] [S8]
- [S6] Ann Handley, 3 Truths Every Story Should Reveal. https://annhandley.com/3-truths-every-story-should-reveal/
+ 11. **Close and deliver.** Confirm the next action, resolve checklist failures, and use [the output template](templates/output-template.md) to present finished copy separately from review notes. Name any remaining blockers precisely. Preparing copy does not itself authorize publication or contacting contributors. [S1] [S5]
- [S7] Ann Handley, What's Your Writing Process? [Sneak Peek At New Data]. https://annhandley.com/writing-process/
+ ## Files in this skill
- [S8] Ann Handley, 3 Approaches to Great Writing. https://annhandley.com/approaches-to-great-writing/
+ - [SKILL.md](SKILL.md): Entry point, usage scope, and the agent's writing loop.
+ - [references/method.md](references/method.md): Detailed principles, decisions, warnings, and agent adaptations.
+ - [references/sources.md](references/sources.md): Fetched public sources and their contributions, indexed by citation.
+ - [examples/worked-examples.md](examples/worked-examples.md): Invented before-and-after illustrations with revision notes.
+ - [templates/output-template.md](templates/output-template.md): Fill-in working brief, copy deliverable, and review notes.
+ - [checklists/review-checklist.md](checklists/review-checklist.md): Pass/fail review criteria and common repairs.