Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section. Transforms your writing process from solo effort to collaborative partnership.
This skill acts as your writing partner, helping you research, outline, draft, and refine content while maintaining your unique voice and style.
| Capability | Description |
|---|---|
| Collaborative Outlining | Structures ideas into coherent outlines |
| Research Assistance | Finds relevant information and adds citations |
| Hook Improvement | Strengthens openings 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 improve through multiple drafts |
Create a dedicated folder for your article:
mkdir ~/writing/my-article-title
cd ~/writing/my-article-title
touch article-draft.md
Recommended folder structure:
~/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
Help me create an outline for an article about [topic]
Example outline structure:
# 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
- Example/evidence
- [Research needed: specific topic]
### Section 2: [Title]
- Key point C
- Key point D
- Data/citation needed
## Conclusion
- Summary of main points
- Call to action
- Final thought
## Research To-Do
- [ ] Find data on [topic]
- [ ] Get examples of [concept]
- [ ] Source citation for [claim]
Research [specific topic] and add citations to my outline
Here's my introduction. Help me make the hook more compelling.
I just finished the "Why This Matters" section. Review it and give feedback.
Review the full draft for flow, clarity, and consistency.
When research is requested:
## Research: [Topic]
Key Findings:
1. **Finding 1**: Description with data [1]
2. **Finding 2**: Description with data [2]
3. **Expert Quote**: "Quote text" - Source [3]
Citations:
[1] Author. (Year). "Title". Publication.
[2] Author. (Year). "Title". Publication.
[3] Author. (Year). Interview/Source.
Original Hook:
"Product management is changing because of AI. In this article, I'll discuss some ways AI affects product managers."
Improved Options:
| Type | Example |
|---|---|
| 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." |
| Question | "What if you could talk to every customer, read every review, and analyze every support ticket - all before your morning coffee?" |
| 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." |
# Feedback: [Section Name]
## What Works Well
- [Strength 1]
- [Strength 2]
- [Strength 3]
## Suggestions for Improvement
### Clarity
- [Specific issue] -> [Suggested fix]
### Flow
- [Transition issue] -> [Better connection]
### Evidence
- [Claim needing support] -> [Add citation or example]
### Style
- [Tone inconsistency] -> [Match your voice better]
## Specific Line Edits
Original:
> [Exact quote from draft]
Suggested:
> [Improved version]
Why: [Explanation]
| Style | Example |
|---|---|
| Inline | Studies show 40% productivity improvement (McKinsey, 2024). |
| Numbered | Studies show 40% productivity improvement [1]. |
| Footnote | Studies show 40% productivity improvement^1 |