MCPInstall

content-writing

Create ridiculously good content using Ann Handley's "Everybody Writes" methodology—practical, reader-focused writing that serves your audience and achieves your goals. Use when: Write blog posts that engage and convert readers; Create email content that gets opened and clicked; Craft social media posts that stop the scroll; Develop website copy that speaks to your audience; Write thought leadership that builds credibility

Installs
379
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/guia-matthieu/clawfu-skills --skill content-writing
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads content-writing automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Content Writing

Create ridiculously good content using Ann Handley's "Everybody Writes" methodology—practical, reader-focused writing that serves your audience and achieves your goals.

When to Use This Skill

Use this skill when you need to:

  • Write blog posts that engage and convert readers
  • Create email content that gets opened and clicked
  • Craft social media posts that stop the scroll
  • Develop website copy that speaks to your audience
  • Write thought leadership that builds credibility
  • Improve existing content that's underperforming
  • Edit your own work with a professional eye
  • Overcome writer's block and produce content consistently
  • Train team members on content writing best practices

This skill is particularly valuable for:

  • Content marketers creating regular blog/newsletter content
  • Marketers wearing multiple hats who need to write
  • Subject matter experts translating expertise into content
  • Teams wanting to elevate content quality
  • Anyone who thinks "I'm not a writer" but has to write anyway

Methodology Foundation

Source: Ann Handley - Everybody Writes: Your Go-To Guide to Creating Ridiculously Good Content (2014, 2nd edition 2022)

Core Principle: Writing isn't a gift—it's a skill. Writing well is part habit, part knowledge of fundamental rules, and part giving a damn about your reader.

"No one will ever complain that you've made things too simple to understand."


What Claude Does vs What You Decide

Claude DoesYou Decide
Structures production workflowFinal creative direction
Suggests technical approachesEquipment and tool choices
Creates templates and checklistsQuality standards
Identifies best practicesBrand/voice decisions
Generates script outlinesFinal script approval

What This Skill Does

When invoked, I will guide you through the Everybody Writes methodology:

  1. Apply the Writing GPS - 12-step framework from idea to published piece
  2. Write for the reader - Develop "pathological empathy" for your audience
  3. Embrace the Ugly First Draft - Separate creating from editing
  4. Edit ruthlessly - Cut, clarify, and polish your work
  5. Adapt to specific formats - Headlines, emails, social, long-form
  6. Build sustainable habits - Consistent quality output

How to Use

Provide information about your content writing challenge:

Example prompts:

  • "Help me write a blog post about [topic]"
  • "Improve this draft—make it clearer and more engaging"
  • "Write email subject lines for our newsletter about [topic]"
  • "Create social media posts promoting our new [product/content]"
  • "I'm stuck on this piece—help me get unstuck"

Information that helps:

  • Your target audience (who are you writing for?)
  • The goal of the content (what action do you want?)
  • The topic or subject matter
  • Existing draft (if any) to improve
  • Format/channel (blog, email, social, etc.)
  • Tone/voice guidelines (if any)

Instructions

The Core Mindset: Writing for the Reader

Every piece of content must answer two questions:

  1. So what? - Why does this matter?
  2. Who cares? - Why should the reader care?

If you can't answer both, your content isn't ready.

Develop "Pathological Empathy":

Ask YourselfWhy It Matters
What does my reader already know?Avoid boring them
What do they need to know?Fill knowledge gaps
What do they want?Align with desires
What do they fear?Address objections
How can I help them?Focus on value

Ann Handley's 13 Writing Rules

Foundation Rules

1. There is no one way to write Find your process. What works for one writer won't work for another.

2. Our words are our emissaries Your writing represents you. Every piece is a chance to build or break trust.

3. Good writing is a power tool It's not optional—it's essential. Treat it as a professional skill.

4. The key to better writing is more writing Practice is non-negotiable. Write regularly, not just when you "feel like it."

5. Writing well is habit + knowledge + caring Know the rules. Practice consistently. Give a damn about your reader.

Clarity Rules

6. No one complains about too-simple writing Simplicity is a gift. Never fear being too clear.

7. Assume ignorance, not stupidity Explain without condescension. Your reader is smart but may not have context.

8. Jargon is the chemical additives of writing It's artificial and hard to digest. Use plain language instead.

Process Rules

9. The Ugly First Draft is necessary Don't skip the messy first attempt. It's how you get to good.

10. Good writers are great editors The magic happens in revision, not the first draft.

11. Editing is about clarity, not just grammar Cut what's unnecessary. Sharpen what's essential.

Discipline Rules

12. You can't wait for inspiration Art that waits for the muse sits on the couch watching Netflix.

13. Deadlines are the WD-40 of writing They keep things moving. Set them, even if self-imposed.


The Writing GPS: 12-Step Framework

Use this framework for any significant piece of content:

Phase 1: Preparation

Step 1: Goal What's the purpose? What action should readers take?

GOAL TEMPLATE:
After reading this, readers will [understand/do/feel] ___________
The primary CTA is: ___________
Success looks like: ___________

Step 2: Reframe Put readers into the picture. Why do THEY care?

Your PerspectiveReader's Perspective
"We launched a new feature""You can now do X faster"
"Our company won an award""We're committed to quality for you"
"Read our latest research""Here's how to solve [problem]"

Step 3: Seek Data Find facts, stats, examples, quotes, stories to support your point.

Step 4: Organize Create a rough structure:

  • What's your hook/lede?
  • What are your 3-5 main points?
  • What's your conclusion/CTA?

Phase 2: Creation

Step 5: Write the Ugly First Draft (TUFD)

"Write with the door closed."

Rules for TUFD:

  • Don't edit while writing
  • Don't research mid-draft
  • Don't worry about perfection
  • Just get ideas down
  • Embrace the mess

Step 6: Walk Away Let it rest. An hour minimum, overnight if possible. Distance creates perspective.

Phase 3: Refinement

Step 7: Rewrite Focus on big-picture issues:

  • Is the structure logical?
  • Does the argument flow?
  • Is the lede strong enough?
  • Does the ending land?

Step 8: Edit for Clarity Cut ruthlessly. For every sentence:

  • Is this necessary?
  • Is this the simplest way to say it?
  • Could this be shorter?

Kill your darlings. That clever phrase you love? If it doesn't serve the reader, cut it.

Step 9: Edit for Grammar and Style Now worry about:

  • Word choice
  • Sentence variety
  • Tone consistency
  • Punctuation

Phase 4: Polish

Step 10: Read Aloud Your ear catches what your eye misses:

  • Awkward phrases
  • Missing words
  • Unnatural rhythm
  • Overlong sentences

Step 11: Get a Second Opinion Fresh eyes see what you can't. Ask someone to read for:

  • Clarity
  • Missing context
  • Confusing passages
  • Overall impression

Step 12: Final Look One last polish, then PUBLISH. Don't let perfect be the enemy of done.


Format-Specific Guidelines

Headlines

Principles:

  • Promise something valuable
  • Be specific (numbers, details)
  • Create curiosity
  • Front-load keywords

Formula Options:

FormulaExample
How to [achieve result]"How to Write Headlines That Convert"
[Number] Ways to [benefit]"7 Ways to Improve Your Email Open Rates"
The [adjective] Guide to [topic]"The Complete Guide to Content Strategy"
[Question your audience asks]"Why Isn't Your Content Converting?"
[Result] in [timeframe]"Better Blog Posts in 30 Minutes"

Leads/Opening Lines

Types that Work:

  1. Start with reader: "You've spent hours on that blog post..."
  2. Provocative question: "What if everything you know about SEO is wrong?"
  3. Surprising fact: "72% of marketers say content is their biggest challenge"
  4. Brief story: "Last week, a client asked me something that stopped me cold..."
  5. Straight to the point: "Here's how to write content that converts."

Avoid:

  • Starting with "We" or "Our company"
  • Long-winded introductions
  • Definitions ("Content marketing is...")
  • Vague generalizations

Email Subject Lines

Best Practices:

  • Clear beats clever (they need to know what's inside)
  • Under 50 characters (for mobile)
  • Create urgency (when genuine)
  • Personalize when possible
  • Test different approaches

Formulas:

TypeExample
Curiosity"This changed how I write forever"
Direct"Your weekly content tips"
Question"Struggling with headlines?"
How-to"How to write faster (without sacrificing quality)"
Urgency"Last day: Content workshop registration"

Social Media Posts

Principles:

  • Stop the scroll (first line matters most)
  • Lead with the hook
  • Offer value immediately
  • Write like you talk
  • Include clear CTAs

Format for Long-Form (LinkedIn):

[Hook: provocative statement or question]

[Space]

[Context: why this matters]

[Key insight or story]

[Takeaway or lesson]

[CTA or question for engagement]

The Editing Checklist

Use this checklist before publishing:

Big Picture:

  • Does the headline promise value?
  • Does the lede hook the reader?
  • Is the structure logical?
  • Is the main point clear?
  • Does the ending land?

Clarity:

  • Have I cut unnecessary words?
  • Is every sentence doing work?
  • Have I eliminated jargon?
  • Would a 12-year-old understand this?

Reader Focus:

  • Have I answered "So what?"
  • Is this about the reader, not me?
  • Have I addressed likely questions?
  • Is the CTA clear?

Polish:

  • Have I read this aloud?
  • Is the grammar correct?
  • Are sentences varied in length?
  • Have I checked for typos?

Examples

Example 1: Blog Post Rewrite

Original Draft (Before):

"In today's fast-paced digital landscape, businesses are increasingly recognizing the importance of leveraging content marketing strategies to enhance their brand visibility and drive meaningful engagement with their target audiences. Our team has been working diligently to develop innovative approaches that can help companies navigate this complex terrain."

Analysis:

  • Starts with "In today's" (cliché)
  • Uses jargon: "leverage," "landscape," "enhance brand visibility"
  • About the company, not the reader
  • No clear point or value

Rewritten (After):

"Your blog has been stuck at 500 monthly visitors for six months. You've published consistently. You've promoted on social. Nothing's working.

Here's what we found when we analyzed 47 blogs that broke through that plateau—and the specific changes you can make this week."

What Changed:

  • Starts with reader's problem
  • Specific (500 visitors, six months, 47 blogs)
  • Promises actionable value
  • No jargon

Example 2: Email Newsletter

Assignment: Write a newsletter introducing a new guide on email marketing.

Using the Writing GPS:

Goal: Get readers to download the guide Reader reframe: They struggle with email—low open rates, low clicks, no results

The Email:

Subject: Your emails aren't the problem

Hey [Name],

I talked to 23 marketers last month about email.

Same frustration every time: "We write good emails. Why doesn't anyone engage?"

Here's what I've realized: the email itself usually isn't the problem.

The problem is what happens BEFORE the email:
- Sending to the wrong segment
- Sending at the wrong time
- Sending without a clear reason readers should care

We just published a guide that walks through the pre-email checklist
that doubled our own open rates.

It's 12 pages. No fluff. Takes 10 minutes to read.

→ Grab it here: [LINK]

If you implement even one thing from it, let me know what changes.

— Ann

P.S. Page 7 has the framework that made the biggest difference for us.

Why It Works:

  • Hook creates curiosity (emails aren't the problem?)
  • Specific data (23 marketers, doubled, 12 pages, 10 minutes)
  • Reader-focused (your frustration, your improvement)
  • Clear CTA with specificity
  • P.S. creates additional curiosity

Checklists & Templates

Content Brief Template

CONTENT BRIEF

Title/Topic: _______________
Format: Blog / Email / Social / Other
Target audience: _______________
Goal (reader action): _______________

KEY QUESTIONS TO ANSWER:
1. What problem does this solve for the reader?
2. What will they know/do after reading?
3. What makes this different from existing content?

MAIN POINTS:
1. _______________
2. _______________
3. _______________

DATA/EXAMPLES NEEDED:
- _______________
- _______________

CTA: _______________

SUCCESS METRICS: _______________

TUFD (Ugly First Draft) Warmup

When stuck, answer these questions quickly without editing:

  1. What's the main thing I want readers to understand?
  2. Why should they care about this?
  3. What's the most interesting angle on this topic?
  4. What story or example illustrates my point?
  5. What should readers do after reading?

Then write for 15 minutes without stopping.

Quick Edit Passes

Pass 1: Structure

  • Does the lede hook?
  • Are sections in logical order?
  • Does the ending work?

Pass 2: Clarity

  • Cut 10% of the words
  • Eliminate jargon
  • Simplify complex sentences

Pass 3: Reader Focus

  • Change "we/our" to "you/your" where possible
  • Ensure benefits are clear
  • Add specificity

Pass 4: Polish

  • Read aloud
  • Fix grammar
  • Check formatting

Skill Boundaries

What This Skill Does Well

  • Structuring audio production workflows
  • Providing technical guidance
  • Creating quality checklists
  • Suggesting creative approaches

What This Skill Cannot Do

  • Replace audio engineering expertise
  • Make subjective creative decisions
  • Access or edit audio files directly
  • Guarantee commercial success

References

Primary Source:

  • Handley, Ann. (2022). Everybody Writes: Your New and Improved Go-To Guide to Creating Ridiculously Good Content (2nd ed.). Wiley.

Additional Resources:

  • Ann Handley's Total Annarchy newsletter
  • MarketingProfs content resources
  • Ann Handley's website: annhandley.com

Related Skills

  • copy-frameworks - AIDA, PAS, and other structural frameworks
  • headline-formulas - Specific headline templates and formulas
  • email-writing - Deeper dive into email copywriting
  • storytelling-storybrand - Using story structure in content
  • seo-content-writer - Optimizing content for search

FAQ

What does the content-writing skill do?

Create ridiculously good content using Ann Handley's "Everybody Writes" methodology—practical, reader-focused writing that serves your audience and achieves your goals. Use when: Write blog posts that engage and convert readers; Create email content that gets opened and clicked; Craft social media posts that stop the scroll; Develop website copy that speaks to your audience; Write thought leadership that builds credibility

How do I install content-writing?

Run npx skills add https://github.com/guia-matthieu/clawfu-skills --skill content-writing in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/content-writing/ (personal) or .claude/skills/content-writing/ (project).

Which AI agents can use content-writing?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is content-writing safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains content-writing?

It is published by guia-matthieu in guia-matthieu/clawfu-skills. It has 379 recorded installs.

More from guia-matthieu/clawfu-skills

View all →

whisper-transcription

guia-matthieu/clawfu-skills

Transcribe audio and video files to text using OpenAI Whisper. Use when: converting podcasts to blog posts; creating video subtitles; extracting quotes from interviews; repurposing video content to text; building searchable audio archives

Media & Creative944 installs

yc-pitch-deck

guia-matthieu/clawfu-skills

Create a compelling startup pitch deck that follows the structure proven to raise billions from top investors. Master the YC and Sequoia formats that get founders funded. Use when: Fundraising to create investor pitch decks; YC application to structure your narrative; Demo Day prep to craft your 2-minute pitch; Angel investors to communicate your opportunity; Partnership pitches to structure compelling asks

Business & Finance807 installs

conversion-copywriting

guia-matthieu/clawfu-skills

Write copy that gets a "yes" using Joanna Wiebe's research-first, Voice of Customer methodology Use when: Writing landing pages, emails, or sales pages that need measurable conversion results; Starting a new copy project and need a systematic process to follow; Struggling with what to write and staring at a blank page; Wanting to prove ROI to clients with data-backed decisions; Improving existing copy through validation and testing

Marketing & SEO696 installs

web-scraper

guia-matthieu/clawfu-skills

Extract structured data from websites. Use when: collecting competitor pricing; scraping product listings; extracting contact information; gathering research data; monitoring website changes

sound-design-film

guia-matthieu/clawfu-skills

Apply Walter Murch's legendary film sound principles to marketing video, creating emotionally resonant audio that audiences feel without consciously noticing. Use when: Designing sound for brand films and documentaries; Creating emotional impact in video ads; Layering music, effects, and voice effectively; Building immersive soundscapes for content; Elevating production value through audio

Media & Creative548 installs

report-generator

guia-matthieu/clawfu-skills

Generate PDF/HTML reports from templates and data. Use when: creating client reports; generating weekly summaries; producing marketing performance reports; automating recurring reports

Docs & Writing502 installs

Popular docs & writing skills

View category →

grill-with-docs

mattpocock/skills

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

Docs & Writing1.2M installs

lark-markdown

open.feishu.cn

飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。

Docs & Writing778.7K installs

writing-beats

mattpocock/skills

Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.

Docs & Writing490.7K installs

writing-shape

mattpocock/skills

Writing, exploit: shape raw material into an article, paragraph by paragraph.

Docs & Writing490.2K installs

writing-fragments

mattpocock/skills

Writing, explore: mine raw fragments, no structure yet.

Docs & Writing489.6K installs

writing-for-agents

mattpocock/skills

Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.

Docs & Writing479.3K installs