MCPInstall

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
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads cw-outline automatically when relevant.

  3. 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

ElementDescription
Logical architectureThe overall structure makes sense for the argument
Clear hierarchyReader can tell what's a main point vs. supporting point
FlowIdeas connect within sections and between sections
Gaps visibleOpen 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

View all →

cw-sedaris

everyinc/compound-writing

Open the skill to read its SKILL.md instructions.

Docs & Writing216 installs

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?

Docs & Writing214 installs

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.

Docs & Writing212 installs

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.

Docs & Writing212 installs

Popular docs & writing skills

View category →

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.

Docs & Writing1.2M installs

lark-markdown

open.feishu.cn

飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。

Docs & Writing778.7K installs

writing-beats

mattpocock/skills

Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.

Docs & Writing490.7K installs

writing-shape

mattpocock/skills

Writing, exploit: shape raw material into an article, paragraph by paragraph.

Docs & Writing490.2K installs

writing-fragments

mattpocock/skills

Writing, explore: mine raw fragments, no structure yet.

Docs & Writing489.6K installs

writing-for-agents

mattpocock/skills

Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.

Docs & Writing479.3K installs