
cw-outline
Organize interview material into a detailed structure using the 10%/30% framework. Invoke with /cw-outline or after completing an interview.
- Installs
- 212
- Last 24h
- +9
- Trending rank
- #9270
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/everyinc/compound-writing --skill cw-outline- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads cw-outline automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Outline
Purpose
Organize material into a structure the writer approves before drafting. Goal: no surprises at the draft stage.
What Makes a Good Outline
| Element | Description |
|---|---|
| Logical architecture | The overall structure makes sense for the argument |
| Clear hierarchy | Reader can tell what's a main point vs. supporting point |
| Flow | Ideas connect within sections and between sections |
| Gaps visible | Open loops and questions are surfaced, not hidden |
Your Approach
Organize material logically; writer reshapes from there. Don't impose templates or force a particular form. Match the outline depth to the piece complexity.
Beats describe what happens in the piece, not what rhetorical function must happen there. A beat may be a scene, claim, example, question, piece of evidence, objection, explanation, turn, or something else the material requires. Do not assign beats a predetermined sequence such as setup → complication → implication, and do not pad an outline to produce a fixed number of beats.
The 10%/30% Framework
A guideline, not a requirement. Use your judgment about how much structure this piece needs.
10% Outline (Light Structure)
What it contains:
- Thesis statement
- The major beats or moves
When it's enough: Short pieces, simple arguments, experienced writers who just need a skeleton.
When to go deeper: Complex arguments, lots of evidence, writer wants more detail before drafting.
30% Outline (Full Structure)
A 30% outline contains the complete shape of the piece in compressed form. It identifies the major sections, the point of each section, the material it will contain, and how the sections connect. It is not 30% of the prose.
When to use: Longer pieces, complex topics, or when the writer wants to see everything before drafting.
Standard 30% Outline Template
Use this as the standard shape, adapting the number of sections and beats to the material.
# 30% Outline
## Introduction
**Main point:**
What the introduction needs to establish.
**Hook:**
How the piece opens.
**Beats:**
- [Beat]
- [Beat]
- [Additional beats as needed]
**Thesis:**
The central claim or controlling idea of the piece.
**Promise:**
What the piece promises to give the reader.
---
## Section: [Working title]
**Main point:**
What this section establishes.
**Transition:**
The move from the previous section into this one.
**Beats:**
- [Beat]
- [Beat]
- [Additional beats as needed]
**Supporting material:**
- [Scene, example, evidence, quotation, research, or other material]
- [Additional supporting material as needed]
**Bottom line:**
What the section leaves established before the piece moves on.
---
## Additional sections as required
Repeat the section structure according to the needs of the piece. The number and nature of the beats should follow the material.
---
## Conclusion
**Main point:**
What the conclusion needs to leave with the reader.
**Transition:**
The move from the final body section into the conclusion.
**Beats:**
- [Beat]
- [Beat]
- [Additional beats as needed]
**Kicker:**
How the piece ends.
---
## Open Loops
- [ ] Missing material:
- [ ] Claim or idea to resolve:
- [ ] Structural question:
- [ ] Transition to work out:
- [ ] Decision requiring the writer's judgment:
The labels are structural prompts, not quotas or a hidden narrative formula:
- Thesis governs the whole piece; main point identifies what an introduction, section, or conclusion establishes.
- Transition names the move between sections. It does not need to be polished prose.
- Beats capture the sequence of material. Their number, kind, and function follow the piece.
- Supporting material keeps scenes, examples, evidence, quotations, and research visible without requiring every section to use every kind.
- Bottom line records what a body section leaves established.
- Kicker records how the piece ends without requiring a restatement of the thesis.
Quality Checks (Apply Judiciously)
These are questions, not gates:
- Does the thesis still hold up?
- Does each section earn its place?
- Are there obvious gaps in evidence or logic?
- Do the sections flow into each other?
Surface issues constructively. Don't block progress—flag concerns and let the writer decide.
Open Loops
Track questions and gaps that emerge:
## Open Loops
- [ ] Need example for section 3
- [ ] Counterargument to address?
- [ ] Ending still unclear
Open loops don't block progress. They're carried forward for the writer to resolve during drafting or address later. Some will resolve naturally; others need explicit attention.
Iteration
Present the outline → get feedback → iterate. Keep it conversational:
- "Here's a 10% outline—does this capture the shape?"
- "Want me to expand this to 30%, or is this enough to draft from?"
- "I flagged a few open loops. Want to resolve them now or carry them forward?"
Completion
The outline is ready when the writer feels ready to draft. This might be:
- A tight 10% for a quick piece
- A detailed 30% for something complex
- Something in between
Don't gatekeep. If the writer says "let's draft," move to draft.
For Agents
When invoked as part of a larger workflow, this skill returns:
- The outline (at whatever depth was appropriate)
- Open loops (if any)
- Readiness assessment for draft stage
Lessons
[Skill-specific lessons will be added here as they're captured]
FAQ
What does the cw-outline skill do?
Organize interview material into a detailed structure using the 10%/30% framework. Invoke with /cw-outline or after completing an interview.
How do I install cw-outline?
Run npx skills add https://github.com/everyinc/compound-writing --skill cw-outline in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/cw-outline/ (personal) or .claude/skills/cw-outline/ (project).
Which AI agents can use cw-outline?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is cw-outline safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains cw-outline?
It is published by everyinc in everyinc/compound-writing. It has 212 recorded installs.
More from everyinc/compound-writing
cw-sedaris
everyinc/compound-writing
Open the skill to read its SKILL.md instructions.
cw-dev-edit
everyinc/compound-writing
Review a draft for big-picture issues in argument, structure, stakes, evidence, and payoff. Use when a piece needs developmental editing, a top-level diagnosis, or substantial restructuring before sentence polish.
cw-hitchcock
everyinc/compound-writing
Reviews for suspense and tension. Where's the bomb under the table? What does the reader know that someone doesn't?
cw-brainstorm
everyinc/compound-writing
Help users surface raw material for a piece when they don't have a specific idea yet. Invoke with /cw-brainstorm or when user says they want to explore ideas.
cw-onboarding
everyinc/compound-writing
Begin or refresh the separate VOICE.md, STYLE.md, and optional AUDIENCE.md guides in a writer's durable writing home from a short conversation, existing writing, or maintained context. Use during first-run writing-home setup and when the user wants to define, calibrate, import, or update voice, style, or audience context.
cw-final-pass
everyinc/compound-writing
Run a publication-readiness check on a nearly complete piece and deliver a clear ready, almost-ready, or needs-work verdict. Use when the user asks for a final pass, quality gate, or pre-publication check.
Popular docs & writing skills
grill-with-docs
mattpocock/skills
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
lark-markdown
open.feishu.cn
飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
writing-beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
writing-shape
mattpocock/skills
Writing, exploit: shape raw material into an article, paragraph by paragraph.
writing-fragments
mattpocock/skills
Writing, explore: mine raw fragments, no structure yet.
writing-for-agents
mattpocock/skills
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.