content-writing

这段内容是审核时保存的快照。外部来源才是完整且最新的版本。

---
name: content-writing
description: Use when drafting or editing website copy of any kind. Use content-writing for general copy and blog-writer for a complete article.
metadata:
  portable: true
  compatible_with:
  - claude-code
  - codex
---

<!-- dual-compat-start -->
# Content Writing Skill

## Overview

Use this skill as the general copywriting and editing standard for websites and marketing content. It applies structure, clarity, persuasion, and scannability across page copy, blog text, and other website content.

## Use When

- Use when drafting or editing website copy of any kind.
- Use when the task needs stronger headlines, flow, readability, or persuasive structure.
- Use as a cross-cutting writing standard alongside more specific content skills.

## Do Not Use When

- Do not use to invent missing strategy, positioning, or proof.
- Do not override a more specific skill that already owns the artifact.
- Do not confuse polished copy with message clarity or business logic.


- Route to `content-writing` instead for general copy, or `blog-writer` for a complete article.
## Required Inputs


| Input | Source / provider | Required? | If absent |
|---|---|---:|---|
| Content Writing brief and decision audience | Client, plan owner, or approved project files | Yes | Stop before making a recommendation; state the missing decision context. |
| Claims, assumptions, and supporting evidence | Source register, model, research notes, interviews, or operating records | Yes | Separate known facts from assumptions and return a qualified gap list. |
| Authority and delivery constraints | Requesting owner and repository instructions | Yes | Remain read-only and produce a draft or review only. |
- Draft copy or a clear content brief
- Audience, page purpose, and conversion goal
- Brand, language, and tone context
- Any adjacent pages or content whose wording must stay aligned

## Workflow

1. Identify what the page or piece of content must achieve.
2. Clarify the reader, promise, and next action.
3. Draft or revise the copy for clarity, persuasion, and scanability.
4. For premium service pages, sales pages, authority content, SEO/AI-search pages, or high-stakes conversion copy, apply `premium-commercial-writing`.
5. Reconcile tone and terminology with the brand and surrounding content.
6. Tighten weak sections, headlines, and transitions.
7. Flag where better inputs or stronger evidence are needed.

### Decision, stop, and recovery controls


- **Decision point:** confirm that the requested output is the reader-ready content draft and that the decision concerns which structure and language help the reader complete the task.
- **Stop condition:** halt the affected conclusion if required evidence is missing (page purpose, reader task, facts, voice, and conversion path) or if the work could lead to this identified risk: polishing generic copy that lacks proof or a usable next step.
- **Recovery:** obtain the missing record or reviewer, repeat the affected check, and update the exception record before release.

## Quality Bar

- The copy is clear, useful, and conversion-aware.
- Headlines and structure make the content easy to navigate.
- Tone matches the intended audience and brand.
- The writing supports the business goal of the page.

## Anti-Patterns

- Vague marketing language with no concrete meaning.
- Long paragraphs that hide the main point.
- Writing that sounds polished but says nothing new.
- Copy choices that conflict with other live pages.
- Treating a generic content writing template as a conclusion. **Correction:** tie each choice to the named audience, evidence, and operating constraint.


- Applying the wrong neighbouring route to content writing. **Correction:** confirm the decision and route to the named neighbour before analysis.
- Treating an assumption as verified evidence. **Correction:** label it, cite its source or owner, and assign a verification action.
- Recommending action without a decision threshold. **Cor