botkitsdev/botkits / skills/writing/botkits-outline
botkits-outline
VerifiedUse this when turning a seed, interview, or set of facts into a writing plan before drafting an article.
README.md
View on GitHub# botkits-outline
Turn a seed, interview notes, or a pile of facts into a writing plan the writer can approve. No prose yet.
Use this when turning a seed, interview, or set of facts into a writing plan before drafting an article.
## Install
```sh
npx skills add botkitsdev/botkits --skill botkits-outline
```
To list every skill in the repo: `npx skills add botkitsdev/botkits --list`.
No CLI? Copy this folder into the skills folder your agent uses, and keep `SKILL.md` inside it.
## What it does
- Starts with one sentence: the claim the piece makes and the one thing a reader will learn. If that sentence is missing, it asks the writer.
- Picks a shape that fits the material and says why: Story to mechanism, Answer first, Teardown, or Changed my mind. Heavy sections get more beats than light ones.
- For each section it records a working heading, the job it does in one line, the facts or examples it will use, and its rough length.
- Adds two or three openings built from something real in the material (a moment, a number, a quote), gaps marked `[GAP: ...]` (never filled by guessing), and a cut list of material that is true but off the point.
- Presents the plan and waits for a yes. After sign-off the chain is botkits-draft, botkits-source-check, botkits-no-ai-slop. The plan can still move once drafting starts.
## Before / after (example)
This example starts with a seed, interview notes, or a pile of facts. There is no claim sentence yet. No shape has been chosen. Missing numbers or quotes are still unmarked, so they could be guessed later. Off-point material has nowhere to go.
After the plan you have a one-sentence claim, a named shape with a reason, a section list with jobs, facts and rough lengths, two or three openings taken from the material, gaps marked `[GAP: ...]`, and a cut list. The plan waits for a yes. Nothing is drafted yet.
## Use it in
- Used daily: Grok Bot.
- Installs with `npx skills add` (tested 18 Nov 2026): Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot and Grok Build.
- Supports the SKILL.md format (vendor docs): Claude apps (upload), ChatGPT (Business, Enterprise, Edu, Healthcare upload), and the other clients listed at [agentskills.io](https://agentskills.io/clients).
- Other agents that support the Agent Skills format can load it. We have not run it there.
- No direct install yet in ChatGPT dots or Meta Muse. Paste the instructions from [SKILL.md](SKILL.md) into a chat.
| Agent | Put this folder here |
| --- | --- |
| Grok Bot | Paste [SKILL.md](SKILL.md) in a 1:1 chat and ask the Bot to save it as a skill. |
| Claude Code | `.claude/skills/botkits-outline/` or `~/.claude/skills/botkits-outline/` |
| Codex | `.agents/skills/botkits-outline/` or `~/.agents/skills/botkits-outline/` |
| Cursor | `.agents/skills/botkits-outline/` or `.cursor/skills/botkits-outline/` |
| Gemini CLI | `.gemini/skills/botkits-outline/` or `.agents/skills/botkits-outline/` (one folder deep only) |
| GitHub Copilot | `.github/skills/botkits-outline/` or `.agents/skills/botkits-outline/` |
| Grok Build | `.grok/skills/botkits-outline/` or `~/.grok/skills/botkits-outline/` |
| Claude apps | Turn on code execution. ZIP this folder and upload it in Customize, Skills. |
Install tested is not run tested.
## Links
- [botkits.dev](https://botkits.dev)
- Instructions: [SKILL.md](SKILL.md)
- Inspired by: [Nadiem Mahmoud's outline](https://github.com/nadiem99/claude-writing-skills/blob/5b52111e1bd30e93643929f17155e82aa26f771f/skills/pipeline/outline/SKILL.md) (MIT), [Paul Graham's Writing, Briefly](https://www.paulgraham.com/writing44.html), and [Google's Technical Writing Two on large documents](https://developers.google.com/tech-writing/two/large-docs). This skill adds a one-sentence claim first, four named shapes, a cut list, and a note that the plan will change during drafting.
License: MIT
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |