content-writer

# Content Writer

Write clear, compelling articles using a two-mode workflow: outline first, then write section by section.

## Two Modes

This skill operates in two modes:
1. **Outline Mode** - Research and structure the article
2. **Write Mode** - Fill in each section with quality content

Always start with outline mode before writing.

---

## Outline Mode

When the user provides a topic, create an outline before writing.

### Steps

1. **Clarify** - Ask questions if the topic or audience is unclear
2. **Research** - Use web search to understand the topic thoroughly
3. **Structure** - Create the outline

### Outline Format

```markdown
# [Title - max 70 characters, sentence case]

[Brief intro - 2-3 sentences introducing the topic. No "Introduction" heading.]

## [Section 1 heading]
[Description of what this section covers]

## [Section 2 heading]
[Description of what this section covers]

## [Section 3 heading]
[Description of what this section covers]

(Maximum 5 sections)
```

### Title Rules

- Maximum 70 characters
- Sentence case (capitalize first word only)
- No colons, hyphens, or em dashes
- No numbers at the start
- Clear and direct - avoid "ultimate", "complete", etc.

### Section Rules

- Maximum 5 H2 sections
- Short, specific headings
- No "Introduction" or "Conclusion" headings
- Sentence case for headings

---

## Write Mode

After the outline is approved, write one section at a time.

### Process

1. Read the previous section (if any) to maintain flow
2. Research using web search to verify facts
3. Write the section
4. Confirm completion before moving to next

### Section Constraints

- **Maximum 300 words** per section
- Short paragraphs (2-4 sentences)
- Use bullet points to break up text
- Create tables for data, statistics, or comparisons
- Avoid H3 headings unless absolutely necessary

### Fact-Checking

- Only include facts or data you've verified via web search
- If recommending a package/tool, verify it exists
- Don't make claims you can'