name: content-research-writer

description: 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.

Content Research Writer

This skill acts as your writing partner, helping you research, outline, draft, and refine content while maintaining your unique voice and style.

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

1. Collaborative Outlining: Helps you structure ideas into coherent outlines
2. Research Assistance: Finds relevant information and adds citations
3. Hook Improvement: Strengthens your opening to capture attention
4. Section Feedback: Reviews each section as you write
5. Voice Preservation: Maintains your writing style and tone
6. Citation Management: Adds and formats references properly
7. Iterative Refinement: Helps you improve through multiple drafts

How to Use

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

1. Start with an outline:

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

1. Research and add citations:

Research [specific topic] and add citations to my outline

1. Improve the hook:

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

1. Get section feedback:

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

1. Refine and polish:

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

Instructions

When a user requests writing assistance:

1. Understand the Writing Project

Ask clarifying questions:

• What's the topic and main argument?
• Who's the target audience?
• What's the desired length/format?
• What's your goal? (educate, persuade, entertain, explain)
• Any existing research or sources to include?
• What's your writing style? (formal, conversational, technical)

1. Collaborative Outlining

Help structure the content:

   # 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
   
   ### Section 3: [Title]
   - Key point E
   - Counter-arguments
   - Resolution
   
   ## 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]

Iterate on outline:

• Adjust based on feedback
• Ensure logical flow
• Identify research gaps
• Mark sections for deep dives

1. Conduct Research

When user requests research on a topic:

• Search for relevant information
• Find credible sources
• Extract key facts, quotes, and data
• Add citations in requested format

Example output:

   ## Research: AI Impact on Productivity
   
   Key Findings:
   
   1. **Productivity Gains**: Studies show 40% time savings for 
      content creation tasks [1]
   
   2. **Adoption Rates**: 67% of knowledge workers use AI tools 
      weekly [2]
   
   3. **Expert Quote**: "AI augments rather than replaces human 
      creativity" - Dr. Jane Smith, MIT [3]
   
   Citations:
   [1] McKinsey Global Institute. (2024). "The Economic Potential 
       of Generative AI"
   [2] Stack Overflow Developer Survey (2024)
   [3] Smith, J. (2024). MIT Technology Review interview
   
   Added to outline under Section 2.

1. Improve Hooks

When user shares an introduction, analyze and strengthen:

Current Hook Analysis:

• What works: [positive elements]
• What could be stronger: [areas for improvement]
• Emotional impact: [current vs. potential]

Suggested Alternatives:

Option 1: [Bold statement]

> [Example]

Why it works: [explanation]

Option 2: [Personal story]

> [Example]

Why it works: [explanation]

Option 3: [Surprising data]

> [Example]

*Why it works: [expl