Content Writer
Create a useful informational draft from a topic, brief, and evidence. Let the reader's needs determine the structure instead of forcing every piece into the same template.
Boundary
Use this skill to draft new general-purpose long-form content.
- For keyword selection, search intent, SEO/AEO optimization, and content-ledger work, use an SEO content workflow instead.
- This skill may honor a supplied style guide while owning the article brief, outline, evidence, and draft. When measured compliance with an existing voice profile is the primary task, use
style-writer.
- For landing pages, sales emails, CTAs, and other conversion-oriented assets, use
direct-response-copy.
- For revision of existing prose, use a rewriting workflow.
- For an evidence-backed critique rather than a draft, use an editorial-review workflow.
The skill must remain useful by itself. Other skills are optional next steps, not dependencies.
Inputs
Collect only what materially affects the draft:
- Topic and intended outcome.
- Audience and what they already know.
- Format, channel, and approximate length.
- Required claims, examples, sources, and terminology.
- Constraints, exclusions, and desired action.
- A supplied style or voice guide, when one should govern the draft.
Ask one concise batch of questions when critical inputs are missing. Do not block on preferences that can be handled with a stated assumption.
Choose the Mode
- Outline first: Use for complex, long, high-stakes, or weakly specified work.
- Direct draft: Use when the brief, evidence, and structure are already clear or when the user asks for a quick draft.
- Section delivery: Use when the user wants to review or publish the piece incrementally.
Approval before drafting is required only when the user requests it or unresolved choices would materially change the piece.
Workflow
1. Resolve the brief
State the working purpose in one sentence. Identify:
- the reader's central question
- the useful answer or governing idea
- what the reader should understand or do afterward
- scope and non-goals
- unresolved assumptions
If the topic is keyword-driven or requires search-opportunity selection, stop and route to the search-optimization workflow rather than silently omitting its research and audit steps.
2. Build an evidence inventory
Separate:
- supplied facts and sources
- facts that require current verification
- examples that illustrate but do not prove a claim
- claims that remain unsupported
Research current or contested claims when tools and permission allow. Otherwise qualify, omit, or flag them. Never invent statistics, quotations, citations, named examples, product behavior, or personal experience.
3. Design the outline
For each proposed section, record:
| Section |
Reader question |
Purpose |
Evidence or example |
Transition job |
|
|
|
|
|
Use as many sections as the argument needs. Avoid generic Introduction and Conclusion headings when specific headings would help the reader more.
4. Draft for meaning
Write the complete argument before polishing individual sentences.
- Answer the reader's main question early.
- Give each section one clear job.
- Put evidence next to the claim it supports.
- Use examples, lists, and tables only when they improve understanding.
- Keep terminology stable.
- Explain necessary jargon on first use.
- Match paragraph and sentence length to the material rather than a fixed quota.
- Preserve nuance, attribution, and uncertainty.
Apply a supplied style guide as a constraint. When formal profile matching is required, the completed brief, evidence plan, or draft may be handed to style-writer for a separate compliance pass. Do not require that skill to produce a useful article, and do not invent a reusable voice from a short excerpt while drafting.
5. Revise for usefulness
Check the piece in this order:
- Completeness: Does it answer the brief and reader questions?
- Evidence: Is each factual claim supplied, verified, qualified, or flagged?
- Structure: Does every section advance the argument without repetition?
- Clarity: Are subjects, actions, terms, and consequences concrete?
- Readability: Do headings, lists, tables, and examples help scanning?
- Voice: Does the draft follow supplied guidance without manufactured personality?
- Ending: Does it stop with the useful conclusion or next action?
Do not apply universal word, punctuation, title-length, section-count, sentence-length, or reading-grade bans. Use explicit project guidance and reader needs.
Output
Return:
- The outline, when outline-first mode was used.
- The complete draft or requested section.
- Material assumptions and unresolved evidence gaps.
- Sources or source notes when research informed the draft.
- Optional next-step suggestions only when another workflow would add clear value.
Write files only when the user requested a path or the surrounding task already establishes one.
Quality Gate
The draft is ready when:
- it fulfills the brief for the stated audience
- the main answer appears before avoidable background
- each section has a distinct purpose
- factual claims are traceable or clearly qualified
- examples and formatting improve comprehension
- no invented evidence, experience, or authorship appears
- supplied voice, terminology, and constraints are preserved
- the draft does not depend on another installed skill
1---2name: content-writer3description: Use when drafting source-grounded general articles, blog posts, how-tos, or guides.4---56# Content Writer78Create a useful informational draft from a topic, brief, and evidence. Let the reader's needs determine the structure instead of forcing every piece into the same template.910## Boundary1112Use this skill to draft new general-purpose long-form content.1314- For keyword selection, search intent, SEO/AEO optimization, and content-ledger work, use an SEO content workflow instead.15- This skill may honor a supplied style guide while owning the article brief, outline, evidence, and draft. When measured compliance with an existing voice profile is the primary task, use `style-writer`.16- For landing pages, sales emails, CTAs, and other conversion-oriented assets, use `direct-response-copy`.17- For revision of existing prose, use a rewriting workflow.18- For an evidence-backed critique rather than a draft, use an editorial-review workflow.1920The skill must remain useful by itself. Other skills are optional next steps, not dependencies.2122## Inputs2324Collect only what materially affects the draft:25261. Topic and intended outcome.272. Audience and what they already know.283. Format, channel, and approximate length.294. Required claims, examples, sources, and terminology.305. Constraints, exclusions, and desired action.316. A supplied style or voice guide, when one should govern the draft.3233Ask one concise batch of questions when critical inputs are missing. Do not block on preferences that can be handled with a stated assumption.3435## Choose the Mode3637- **Outline first:** Use for complex, long, high-stakes, or weakly specified work.38- **Direct draft:** Use when the brief, evidence, and structure are already clear or when the user asks for a quick draft.39- **Section delivery:** Use when the user wants to review or publish the piece incrementally.4041Approval before drafting is required only when the user requests it or unresolved choices would materially change the piece.4243## Workflow4445### 1. Resolve the brief4647State the working purpose in one sentence. Identify:4849- the reader's central question50- the useful answer or governing idea51- what the reader should understand or do afterward52- scope and non-goals53- unresolved assumptions5455If the topic is keyword-driven or requires search-opportunity selection, stop and route to the search-optimization workflow rather than silently omitting its research and audit steps.5657### 2. Build an evidence inventory5859Separate:6061- supplied facts and sources62- facts that require current verification63- examples that illustrate but do not prove a claim64- claims that remain unsupported6566Research current or contested claims when tools and permission allow. Otherwise qualify, omit, or flag them. Never invent statistics, quotations, citations, named examples, product behavior, or personal experience.6768### 3. Design the outline6970For each proposed section, record:7172| Section | Reader question | Purpose | Evidence or example | Transition job |73| --- | --- | --- | --- | --- |74| | | | | |7576Use as many sections as the argument needs. Avoid generic `Introduction` and `Conclusion` headings when specific headings would help the reader more.7778### 4. Draft for meaning7980Write the complete argument before polishing individual sentences.8182- Answer the reader's main question early.83- Give each section one clear job.84- Put evidence next to the claim it supports.85- Use examples, lists, and tables only when they improve understanding.86- Keep terminology stable.87- Explain necessary jargon on first use.88- Match paragraph and sentence length to the material rather than a fixed quota.89- Preserve nuance, attribution, and uncertainty.9091Apply a supplied style guide as a constraint. When formal profile matching is required, the completed brief, evidence plan, or draft may be handed to `style-writer` for a separate compliance pass. Do not require that skill to produce a useful article, and do not invent a reusable voice from a short excerpt while drafting.9293### 5. Revise for usefulness9495Check the piece in this order:96971. **Completeness:** Does it answer the brief and reader questions?982. **Evidence:** Is each factual claim supplied, verified, qualified, or flagged?993. **Structure:** Does every section advance the argument without repetition?1004. **Clarity:** Are subjects, actions, terms, and consequences concrete?1015. **Readability:** Do headings, lists, tables, and examples help scanning?1026. **Voice:** Does the draft follow supplied guidance without manufactured personality?1037. **Ending:** Does it stop with the useful conclusion or next action?104105Do not apply universal word, punctuation, title-length, section-count, sentence-length, or reading-grade bans. Use explicit project guidance and reader needs.106107## Output108109Return:1101111. The outline, when outline-first mode was used.1122. The complete draft or requested section.1133. Material assumptions and unresolved evidence gaps.1144. Sources or source notes when research informed the draft.1155. Optional next-step suggestions only when another workflow would add clear value.116117Write files only when the user requested a path or the surrounding task already establishes one.118119## Quality Gate120121The draft is ready when:122123- it fulfills the brief for the stated audience124- the main answer appears before avoidable background125- each section has a distinct purpose126- factual claims are traceable or clearly qualified127- examples and formatting improve comprehension128- no invented evidence, experience, or authorship appears129- supplied voice, terminology, and constraints are preserved130- the draft does not depend on another installed skill