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.
Add this skill
npx mdskills install ComposioHQ/content-research-writerTransforms writing into collaborative process with research, citations, section feedback, and iterative refinement
1---2name: content-research-writer3description: 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.4---56# Content Research Writer78This skill acts as your writing partner, helping you research, outline, draft, and refine content while maintaining your unique voice and style.910## When to Use This Skill1112- Writing blog posts, articles, or newsletters13- Creating educational content or tutorials14- Drafting thought leadership pieces15- Researching and writing case studies16- Producing technical documentation with sources17- Writing with proper citations and references18- Improving hooks and introductions19- Getting section-by-section feedback while writing2021## What This Skill Does22231. **Collaborative Outlining**: Helps you structure ideas into coherent outlines242. **Research Assistance**: Finds relevant information and adds citations253. **Hook Improvement**: Strengthens your opening to capture attention264. **Section Feedback**: Reviews each section as you write275. **Voice Preservation**: Maintains your writing style and tone286. **Citation Management**: Adds and formats references properly297. **Iterative Refinement**: Helps you improve through multiple drafts3031## How to Use3233### Setup Your Writing Environment3435Create a dedicated folder for your article:36```37mkdir ~/writing/my-article-title38cd ~/writing/my-article-title39```4041Create your draft file:42```43touch article-draft.md44```4546Open Claude Code from this directory and start writing.4748### Basic Workflow49501. **Start with an outline**:51```52Help me create an outline for an article about [topic]53```54552. **Research and add citations**:56```57Research [specific topic] and add citations to my outline58```59603. **Improve the hook**:61```62Here's my introduction. Help me make the hook more compelling.63```64654. **Get section feedback**:66```67I just finished the "Why This Matters" section. Review it and give feedback.68```69705. **Refine and polish**:71```72Review the full draft for flow, clarity, and consistency.73```7475## Instructions7677When a user requests writing assistance:78791. **Understand the Writing Project**8081 Ask clarifying questions:82 - What's the topic and main argument?83 - Who's the target audience?84 - What's the desired length/format?85 - What's your goal? (educate, persuade, entertain, explain)86 - Any existing research or sources to include?87 - What's your writing style? (formal, conversational, technical)88892. **Collaborative Outlining**9091 Help structure the content:9293 ```markdown94 # Article Outline: [Title]9596 ## Hook97 - [Opening line/story/statistic]98 - [Why reader should care]99100 ## Introduction101 - Context and background102 - Problem statement103 - What this article covers104105 ## Main Sections106107 ### Section 1: [Title]108 - Key point A109 - Key point B110 - Example/evidence111 - [Research needed: specific topic]112113 ### Section 2: [Title]114 - Key point C115 - Key point D116 - Data/citation needed117118 ### Section 3: [Title]119 - Key point E120 - Counter-arguments121 - Resolution122123 ## Conclusion124 - Summary of main points125 - Call to action126 - Final thought127128 ## Research To-Do129 - [ ] Find data on [topic]130 - [ ] Get examples of [concept]131 - [ ] Source citation for [claim]132 ```133134 **Iterate on outline**:135 - Adjust based on feedback136 - Ensure logical flow137 - Identify research gaps138 - Mark sections for deep dives1391403. **Conduct Research**141142 When user requests research on a topic:143144 - Search for relevant information145 - Find credible sources146 - Extract key facts, quotes, and data147 - Add citations in requested format148149 Example output:150 ```markdown151 ## Research: AI Impact on Productivity152153 Key Findings:154155 1. **Productivity Gains**: Studies show 40% time savings for156 content creation tasks [1]157158 2. **Adoption Rates**: 67% of knowledge workers use AI tools159 weekly [2]160161 3. **Expert Quote**: "AI augments rather than replaces human162 creativity" - Dr. Jane Smith, MIT [3]163164 Citations:165 [1] McKinsey Global Institute. (2024). "The Economic Potential166 of Generative AI"167 [2] Stack Overflow Developer Survey (2024)168 [3] Smith, J. (2024). MIT Technology Review interview169170 Added to outline under Section 2.171 ```1721734. **Improve Hooks**174175 When user shares an introduction, analyze and strengthen:176177 **Current Hook Analysis**:178 - What works: [positive elements]179 - What could be stronger: [areas for improvement]180 - Emotional impact: [current vs. potential]181182 **Suggested Alternatives**:183184 Option 1: [Bold statement]185 > [Example]186 *Why it works: [explanation]*187188 Option 2: [Personal story]189 > [Example]190 *Why it works: [explanation]*191192 Option 3: [Surprising data]193 > [Example]194 *Why it works: [explanation]*195196 **Questions to hook**:197 - Does it create curiosity?198 - Does it promise value?199 - Is it specific enough?200 - Does it match the audience?2012025. **Provide Section-by-Section Feedback**203204 As user writes each section, review for:205206 ```markdown207 # Feedback: [Section Name]208209 ## What Works Well ✓210 - [Strength 1]211 - [Strength 2]212 - [Strength 3]213214 ## Suggestions for Improvement215216 ### Clarity217 - [Specific issue] → [Suggested fix]218 - [Complex sentence] → [Simpler alternative]219220 ### Flow221 - [Transition issue] → [Better connection]222 - [Paragraph order] → [Suggested reordering]223224 ### Evidence225 - [Claim needing support] → [Add citation or example]226 - [Generic statement] → [Make more specific]227228 ### Style229 - [Tone inconsistency] → [Match your voice better]230 - [Word choice] → [Stronger alternative]231232 ## Specific Line Edits233234 Original:235 > [Exact quote from draft]236237 Suggested:238 > [Improved version]239240 Why: [Explanation]241242 ## Questions to Consider243 - [Thought-provoking question 1]244 - [Thought-provoking question 2]245246 Ready to move to next section!247 ```2482496. **Preserve Writer's Voice**250251 Important principles:252253 - **Learn their style**: Read existing writing samples254 - **Suggest, don't replace**: Offer options, not directives255 - **Match tone**: Formal, casual, technical, friendly256 - **Respect choices**: If they prefer their version, support it257 - **Enhance, don't override**: Make their writing better, not different258259 Ask periodically:260 - "Does this sound like you?"261 - "Is this the right tone?"262 - "Should I be more/less [formal/casual/technical]?"2632647. **Citation Management**265266 Handle references based on user preference:267268 **Inline Citations**:269 ```markdown270 Studies show 40% productivity improvement (McKinsey, 2024).271 ```272273 **Numbered References**:274 ```markdown275 Studies show 40% productivity improvement [1].276277 [1] McKinsey Global Institute. (2024)...278 ```279280 **Footnote Style**:281 ```markdown282 Studies show 40% productivity improvement^1283284 ^1: McKinsey Global Institute. (2024)...285 ```286287 Maintain a running citations list:288 ```markdown289 ## References290291 1. Author. (Year). "Title". Publication.292 2. Author. (Year). "Title". Publication.293 ...294 ```2952968. **Final Review and Polish**297298 When draft is complete, provide comprehensive feedback:299300 ```markdown301 # Full Draft Review302303 ## Overall Assessment304305 **Strengths**:306 - [Major strength 1]307 - [Major strength 2]308 - [Major strength 3]309310 **Impact**: [Overall effectiveness assessment]311312 ## Structure & Flow313 - [Comments on organization]314 - [Transition quality]315 - [Pacing assessment]316317 ## Content Quality318 - [Argument strength]319 - [Evidence sufficiency]320 - [Example effectiveness]321322 ## Technical Quality323 - Grammar and mechanics: [assessment]324 - Consistency: [assessment]325 - Citations: [completeness check]326327 ## Readability328 - Clarity score: [evaluation]329 - Sentence variety: [evaluation]330 - Paragraph length: [evaluation]331332 ## Final Polish Suggestions333334 1. **Introduction**: [Specific improvements]335 2. **Body**: [Specific improvements]336 3. **Conclusion**: [Specific improvements]337 4. **Title**: [Options if needed]338339 ## Pre-Publish Checklist340 - [ ] All claims sourced341 - [ ] Citations formatted342 - [ ] Examples clear343 - [ ] Transitions smooth344 - [ ] Call to action present345 - [ ] Proofread for typos346347 Ready to publish! 🚀348 ```349350## Examples351352### Example 1: Teresa Torres's Workflow353354**User**: "I'm writing an article about continuous discovery. Help me create an outline."355356**Process**:3571. Collaborates on outline structure3582. Identifies research needs3593. User starts writing introduction3604. Reviews and improves the hook3615. User writes each section3626. Provides feedback after each section3637. Conducts research and adds citations3648. Final review of complete draft3659. Polish and prep for publishing366367**Result**: Well-researched, properly cited article written in Teresa's voice with strong structure and flow.368369### Example 2: Research-Heavy Article370371**User**: "I'm writing about AI's impact on product management. Help me find current data and examples."372373**Output**:374```markdown375## Research Compiled376377### Recent Data378- Gartner: 80% of PMs will use AI tools by 2025 [1]379- Survey: 45% report faster feature shipping [2]380- Case study: Airbnb's AI-assisted prioritization [3]381382### Expert Quotes383- "AI amplifies PM judgment, not replaces it" - Marty Cagan384- [Additional quotes with citations]385386### Real Examples3871. **Company A**: Used AI for user research synthesis388 - Result: 60% time savings389 - Source: [citation]3903912. **Company B**: AI-powered roadmap analysis392 - Result: Better stakeholder alignment393 - Source: [citation]394395All added to your outline with proper citations.396```397398### Example 3: Hook Improvement399400**User's Original Hook**:401> "Product management is changing because of AI. In this article, I'll discuss some ways AI affects product managers."402403**Improved Options**:404405**Option 1 (Data-driven)**:406> "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."407408**Option 2 (Question)**:409> "What if you could talk to every customer, read every review, and analyze every support ticket—all before your morning coffee?"410411**Option 3 (Story)**:412> "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."413414### Example 4: Section Feedback415416**User**: "Just finished my 'Common Mistakes' section. Thoughts?"417418**Response**:419```markdown420# Feedback: Common Mistakes Section421422## What Works Well ✓423- Strong examples (the Slack notification story)424- Clear structure (3 mistakes, clean layout)425- Practical advice for each mistake426427## Suggestions428429### Make It More Specific430Your second point says "Bad prioritization" but could be stronger:431432Current:433> "Many teams prioritize badly by focusing on features instead of outcomes."434435Suggested:436> "I've watched teams ship 14 features in a quarter yet move none of their key metrics. They prioritized activity over progress."437438### Add Data439The third mistake would benefit from evidence:440> "[Add citation]: Studies show teams without regular user contact are 3x more likely to build unused features [needs source]"441442### Flow Improvement443Consider reordering: Mistake 3 → Mistake 2 → Mistake 1444This builds from small to big impact.445446Ready for the next section!447```448449## Writing Workflows450451### Blog Post Workflow4521. Outline together4532. Research key points4543. Write introduction → get feedback4554. Write body sections → feedback each4565. Write conclusion → final review4576. Polish and edit458459### Newsletter Workflow4601. Discuss hook ideas4612. Quick outline (shorter format)4623. Draft in one session4634. Review for clarity and links4645. Quick polish465466### Technical Tutorial Workflow4671. Outline steps4682. Write code examples4693. Add explanations4704. Test instructions4715. Add troubleshooting section4726. Final review for accuracy473474### Thought Leadership Workflow4751. Brainstorm unique angle4762. Research existing perspectives4773. Develop your thesis4784. Write with strong POV4795. Add supporting evidence4806. Craft compelling conclusion481482## Pro Tips4834841. **Work in VS Code**: Better than web Claude for long-form writing4852. **One section at a time**: Get feedback incrementally4863. **Save research separately**: Keep a research.md file4874. **Version your drafts**: article-v1.md, article-v2.md, etc.4885. **Read aloud**: Use feedback to identify clunky sentences4896. **Set deadlines**: "I want to finish the draft today"4907. **Take breaks**: Write, get feedback, pause, revise491492## File Organization493494Recommended structure for writing projects:495496```497~/writing/article-name/498├── outline.md # Your outline499├── research.md # All research and citations500├── draft-v1.md # First draft501├── draft-v2.md # Revised draft502├── final.md # Publication-ready503├── feedback.md # Collected feedback504└── sources/ # Reference materials505 ├── study1.pdf506 └── article2.md507```508509## Best Practices510511### For Research512- Verify sources before citing513- Use recent data when possible514- Balance different perspectives515- Link to original sources516517### For Feedback518- Be specific about what you want: "Is this too technical?"519- Share your concerns: "I'm worried this section drags"520- Ask questions: "Does this flow logically?"521- Request alternatives: "What's another way to explain this?"522523### For Voice524- Share examples of your writing525- Specify tone preferences526- Point out good matches: "That sounds like me!"527- Flag mismatches: "Too formal for my style"528529## Related Use Cases530531- Creating social media posts from articles532- Adapting content for different audiences533- Writing email newsletters534- Drafting technical documentation535- Creating presentation content536- Writing case studies537- Developing course outlines538539
Full transparency — inspect the skill content before installing.