When to Use This Skill

Writing blog posts, articles, or newsletters
Creating educational content or tutorials
Drafting thought leadership pieces
Researching and writing case studies
Producing technical documentation with sources
Writing with proper citations and references
Improving hooks and introductions
Getting section-by-section feedback while writing

What This Skill Does

Collaborative Outlining

Helps you structure ideas into coherent outlines

Research Assistance

Finds relevant information and adds citations

Hook Improvement

Strengthens your opening to capture attention

Section Feedback

Reviews each section as you write

Voice Preservation

Maintains your writing style and tone

Citation Management

Adds and formats references properly

Iterative Refinement

Helps you improve through multiple drafts

Setup Your Writing Environment

Create a dedicated folder for your article:

mkdir ~/writing/my-article-title
cd ~/writing/my-article-title

Create your draft file:

touch article-draft.md

Open Claude Code from this directory and start writing.

Basic Workflow

Start with an outline

Help me create an outline for an article about [topic]

Research and add citations

Research [specific topic] and add citations to my outline

Improve the hook

Here's my introduction. Help me make the hook more compelling.

Get section feedback

I just finished the "Why This Matters" section. Review it and give feedback.

Refine and polish

Review the full draft for flow, clarity, and consistency.

Example: Hook Improvement

User's Original Hook:

"Product management is changing because of AI. In this article, I'll discuss some ways AI affects product managers."

Improved Options:

Option 1: Data-driven

"Last month, I asked AI to analyze 500 customer interviews. It took 30 minutes instead of 3 weeks. Product management will never be the same."

Option 2: Question

"What if you could talk to every customer, read every review, and analyze every support ticket—all before your morning coffee?"

Option 3: Story

"Sarah spent two weeks building the wrong feature. Not because she didn't understand her users, but because she couldn't process the hundreds of interviews fast enough to spot the pattern."

Recommended File Organization

~/writing/article-name/
├── outline.md          # Your outline
├── research.md         # All research and citations
├── draft-v1.md         # First draft
├── draft-v2.md         # Revised draft
├── final.md            # Publication-ready
├── feedback.md         # Collected feedback
└── sources/            # Reference materials
    ├── study1.pdf
    └── article2.md

Pro Tips

1.Work in VS Code: Better than web Claude for long-form writing

2.One section at a time: Get feedback incrementally

3.Save research separately: Keep a research.md file

4.Version your drafts: article-v1.md, article-v2.md, etc.

5.Read aloud: Use feedback to identify clunky sentences

6.Set deadlines: "I want to finish the draft today"

7.Take breaks: Write, get feedback, pause, revise

Related Use Cases

Creating social media posts from articlesAdapting content for different audiencesWriting email newslettersDrafting technical documentationCreating presentation contentWriting case studiesDeveloping course outlines

Content Research Writer