article-writing
Scannednpx machina-cli add skill affaan-m/everything-claude-code/article-writing --openclawArticle Writing
Write long-form content that sounds like a real person or brand, not generic AI output.
When to Activate
- drafting blog posts, essays, launch posts, guides, tutorials, or newsletter issues
- turning notes, transcripts, or research into polished articles
- matching an existing founder, operator, or brand voice from examples
- tightening structure, pacing, and evidence in already-written long-form copy
Core Rules
- Lead with the concrete thing: example, output, anecdote, number, screenshot description, or code block.
- Explain after the example, not before.
- Prefer short, direct sentences over padded ones.
- Use specific numbers when available and sourced.
- Never invent biographical facts, company metrics, or customer evidence.
Voice Capture Workflow
If the user wants a specific voice, collect one or more of:
- published articles
- newsletters
- X / LinkedIn posts
- docs or memos
- a short style guide
Then extract:
- sentence length and rhythm
- whether the voice is formal, conversational, or sharp
- favored rhetorical devices such as parentheses, lists, fragments, or questions
- tolerance for humor, opinion, and contrarian framing
- formatting habits such as headers, bullets, code blocks, and pull quotes
If no voice references are given, default to a direct, operator-style voice: concrete, practical, and low on hype.
Banned Patterns
Delete and rewrite any of these:
- generic openings like "In today's rapidly evolving landscape"
- filler transitions such as "Moreover" and "Furthermore"
- hype phrases like "game-changer", "cutting-edge", or "revolutionary"
- vague claims without evidence
- biography or credibility claims not backed by provided context
Writing Process
- Clarify the audience and purpose.
- Build a skeletal outline with one purpose per section.
- Start each section with evidence, example, or scene.
- Expand only where the next sentence earns its place.
- Remove anything that sounds templated or self-congratulatory.
Structure Guidance
Technical Guides
- open with what the reader gets
- use code or terminal examples in every major section
- end with concrete takeaways, not a soft summary
Essays / Opinion Pieces
- start with tension, contradiction, or a sharp observation
- keep one argument thread per section
- use examples that earn the opinion
Newsletters
- keep the first screen strong
- mix insight with updates, not diary filler
- use clear section labels and easy skim structure
Quality Gate
Before delivering:
- verify factual claims against provided sources
- remove filler and corporate language
- confirm the voice matches the supplied examples
- ensure every section adds new information
- check formatting for the intended platform
Source
git clone https://github.com/affaan-m/everything-claude-code/blob/main/.cursor/skills/article-writing/SKILL.mdView on GitHub Overview
article-writing helps create long-form content—articles, guides, blog posts, tutorials, and newsletters—with a distinctive voice derived from brand guidance. It emphasizes voice consistency, structure, and credibility to deliver polished pieces beyond a paragraph.
How This Skill Works
Use the Voice Capture Workflow to derive the target voice from provided references (articles, newsletters, posts, docs, or a style guide) and set rhythm, formality, and formatting. Then build a skeletal outline with one purpose per section, start each section with evidence, and expand only when needed. Apply Core Rules and perform a final check against sources to keep facts accurate and remove filler.
When to Use It
- Drafting blog posts, essays, launch posts, guides, tutorials, or newsletter issues
- Turning notes, transcripts, or research into polished articles
- Matching an existing founder, operator, or brand voice from examples
- Tightening structure, pacing, and evidence in already-written long-form copy
- Refining newsletters or long-form content for consistent voice and credibility
Quick Start
- Step 1: Clarify audience and purpose for the piece
- Step 2: Build a skeletal outline with one purpose per section
- Step 3: Start each section with evidence or an example, then expand if needed
Best Practices
- Lead with the concrete thing: output, anecdote, or example first in each section
- Explain after the example, not before, to maintain impact
- Prefer short, direct sentences over padding or fluff
- Use specific numbers when available and sourced
- Never invent biographical facts, company metrics, or customer evidence
Example Use Cases
- Rewrite a company blog post to match the founder's voice using provided articles
- Transform notes from a conference into a polished, structured guide
- Convert a draft tutorial into a citation-backed, easy-to-scan article
- Turn a transcript into a newsletter issue with clear sections and tone
- Refine an old whitepaper into a concise, readable long-form piece