content-writing

<!-- Adapted from: awesome-claude-skills/content-research-writer -->

Content Research & Writing Guide

Collaborative writing partner for articles, blog posts, and documentation.

Workflow Overview

1. Outline - Structure ideas collaboratively
2. Research - Find sources and add citations
3. Write - Draft section by section
4. Feedback - Get review on each section
5. Polish - Final review and refinement

File Organization

~/writing/article-name/
├── outline.md          # Structure
├── research.md         # Sources and citations
├── draft-v1.md         # First draft
├── draft-v2.md         # Revised
├── final.md            # Publication-ready
└── sources/            # Reference materials

Outline Template

# Article Outline: [Title]

## Hook
- Opening line/story/statistic
- Why reader should care

## Introduction
- Context and background
- Problem statement
- What this article covers

## Main Sections

### Section 1: [Title]
- Key point A
- Key point B
- [Research needed: topic]

### Section 2: [Title]
- Key point C
- Evidence/data needed

## Conclusion
- Summary
- Call to action
- Final thought

## Research To-Do
- [ ] Find data on [topic]
- [ ] Source for [claim]

Hook Improvement

When reviewing introductions, consider:

• Does it create curiosity?
• Does it promise value?
• Is it specific enough?
• Does it match the audience?

Hook Types

Type	Example
Bold statement	"Product management will never be the same."
Question	"What if you could talk to every customer before coffee?"
Story	"Sarah spent two weeks building the wrong feature..."
Data	"Last month, AI analyzed 500 interviews in 30 minutes."

Section Feedback Format

# Feedback: [Section Name]

## What Works Well ✓
- [Strength 1]
- [Strength 2]

## Suggestions

### Clarity
- [Issue] → [Fix]

### Flow
- [Transition issue] → [Better connection]

### Evidence
- [Claim needing support] → [Add citation]

## Specific Line Edits

Original:
> [Quote from draft]

Suggested:
> [Improved version]

Why: [Explanation]

Citation Formats

Inline:

Studies show 40% improvement (McKinsey, 2024).

Numbered:

Studies show 40% improvement [1].

[1] McKinsey Global Institute. (2024)...

Pre-Publish Checklist

• All claims sourced
• Citations formatted
• Examples clear
• Transitions smooth
• Call to action present
• Proofread for typos

Voice Preservation

• Learn writer's style from samples
• Suggest, don't replace
• Match tone (formal/casual/technical)
• Ask: "Does this sound like you?"