Plannotator Annotate
backnotprop/plannotator
Opens Plannotator's annotation UI on a markdown file, HTML file, URL or folder, then reads the decision and feedback you send back and acts on it.
Create and execute phased implementation plans stored in .agents/plans using numbered markdown files with YAML front matter and checklist steps.
Install Planning
$ npx skills add championswimmer/pi-context-prune --skill planning -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install championswimmer/pi-context-prune planning --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/championswimmer/pi-context-prune.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/planning .claude/skills/planning && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "planning" agent skill from https://github.com/championswimmer/pi-context-prune/tree/main/.agents/skills/planning into .claude/skills/planning/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "planning", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/championswimmer/pi-context-prune/tree/main/.agents/skills/planningType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add championswimmer/pi-context-prune --skill planning -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install championswimmer/pi-context-prune planning --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/championswimmer/pi-context-prune.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/planning .agents/skills/planning && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "planning" agent skill from https://github.com/championswimmer/pi-context-prune/tree/main/.agents/skills/planning into .agents/skills/planning/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "planning", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add championswimmer/pi-context-prune --skill planning -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install championswimmer/pi-context-prune planning --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/championswimmer/pi-context-prune.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/planning .cursor/skills/planning && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "planning" agent skill from https://github.com/championswimmer/pi-context-prune/tree/main/.agents/skills/planning into .cursor/skills/planning/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "planning", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/championswimmer/pi-context-prune.git --path .agents/skills/planning--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add championswimmer/pi-context-prune --skill planning -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install championswimmer/pi-context-prune planning --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/championswimmer/pi-context-prune.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/planning .gemini/skills/planning && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "planning" agent skill from https://github.com/championswimmer/pi-context-prune/tree/main/.agents/skills/planning into .gemini/skills/planning/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "planning", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install championswimmer/pi-context-prune planningInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add championswimmer/pi-context-prune --skill planning -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/championswimmer/pi-context-prune.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/planning .github/skills/planning && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "planning" agent skill from https://github.com/championswimmer/pi-context-prune/tree/main/.agents/skills/planning into .github/skills/planning/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "planning", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add championswimmer/pi-context-prune --skill planning -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install championswimmer/pi-context-prune planning --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/championswimmer/pi-context-prune.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/planning .opencode/skills/planning && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "planning" agent skill from https://github.com/championswimmer/pi-context-prune/tree/main/.agents/skills/planning into .opencode/skills/planning/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "planning", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
planning- GitHub stars
- 245
- Token cost
- ~779 tokens
- SKILL.md length
- 327 words
- Files
- 1
- Skills in repo
- 2
- Repo updated
- First seen
- Licence
- None found
At a glance
Create and execute phased implementation plans stored in .agents/plans using numbered markdown files with YAML front matter and checklist steps.
- Works in 6 steps: Inspect the current repo state. → Define the outcome in one sentence. → Split the work into phases. → …
- Tasks that involve Markdown
- SKILL.md covers Plan location, Plan format, Body format and How to make a plan, plus 2 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Planning is an agent skill from championswimmer/pi-context-prune. Create and execute phased implementation plans stored in .agents/plans using numbered markdown files with YAML front matter and checklist steps.
Its SKILL.md is about 780 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Agent Workflows, covering Markdown and Planning. The repository describes itself as: Pi coding-agent extension for pruning tool-call trees.
When your agent uses it
- Tasks that involve Markdown
- Tasks that involve Planning
Example prompts
- “/planning”
Workflow steps
6 steps, taken from the first numbered list in SKILL.md.
- Inspect the current repo state.
- Define the outcome in one sentence.
- Split the work into phases.
- Break each phase into small checklist items.
- Save the plan as a numbered Markdown file in .agents/plans/.
- Keep checklist items concrete and actionable.
What it can do on your machine
Read from SKILL.md and the folder at commit 7f27bee. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are yaml and markdown).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Planning loads about 779 tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 327 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
Without a licence we can't republish the file, so here is its outline and opening line. It has 327 words (~779 tokens).
“Use this skill whenever work should be organized into explicit phases and tracked as a plan file.”
- name
- planning
Files
Just SKILL.md in .agents/skills/planning of championswimmer/pi-context-prune.
Open the folder on GitHubat commit 7f27bee
Compare with similar skills
Planning next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Planning this skillchampionswimmer/pi-context-prune | 245 | — | ~779 | Automated safety check: Pass | None | |
| Plannotator Annotatebacknotprop/plannotator | 9.3k | — | ~413 | Automated safety check: Pass | Apache-2.0 | |
| Plannotator Visual Explainerbacknotprop/plannotator | 9.3k | — | ~1.7k | Automated safety check: Pass | Apache-2.0 | |
| Create SkillPINA-org/PINA | 798 | — | ~1.8k | Automated safety check: Pass | MIT | |
| Writing Docsc15t/c15t | 1.9k | — | ~872 | Automated safety check: Pass | Apache-2.0 | |
| Dex Plandcramer/dex | 385 | — | ~3.2k | Automated safety check: Pass | MIT |
Similar skills
Plannotator Visual Explainer
backnotprop/plannotator
Builds self-contained HTML explainers for plans, pull requests and technical concepts in Plannotator's theme, then opens them in its annotation view.
Create Skill
PINA-org/PINA
Create, modify, and improve PINA skills. An agent skill from PINA-org/PINA.
Writing Docs
c15t/c15t
Author or edit c15t documentation in docs//.mdx — the source for both the c15t.com site and the docs bundled into published packages.
Dex Plan
dcramer/dex
Create dex task from markdown planning documents (plans, specs, design docs, roadmaps)
PRP Visual Companion Page
Wirasm/prp
Writes a self-contained HTML companion beside a PRP plan or review that shows the diagram, steps, risks, verdict and findings, each item with a stable id.
More from championswimmer/pi-context-prune
Release
championswimmer/pi-context-prune
Creates a repository release for this Pi package. An agent skill from championswimmer/pi-context-prune.
Related
Categories
Questions about Planning
What does Planning do?
Create and execute phased implementation plans stored in .agents/plans using numbered markdown files with YAML front matter and checklist steps. Planning is an agent skill from championswimmer/pi-context-prune.agents/plans using numbered markdown files with YAML front matter and checklist steps.
When should I use Planning?
Planning fits situations like: tasks that involve Markdown; tasks that involve Planning.
How do I install Planning in Claude Code?
Run `npx skills add championswimmer/pi-context-prune --skill planning -a claude-code`. Or copy the skill folder (.agents/skills/planning in championswimmer/pi-context-prune) into .claude/skills/planning in your project. Claude Code loads it when a task matches its description.
How do I install Planning in Codex?
Run `npx skills add championswimmer/pi-context-prune --skill planning -a codex`. Or copy the skill folder (.agents/skills/planning in championswimmer/pi-context-prune) into .agents/skills/planning in your project. Codex loads it when a task matches its description.
Can I use Planning in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add championswimmer/pi-context-prune --skill planning -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/planning, .gemini/skills/planning, .github/skills/planning and .opencode/skills/planning in your project.
What does Planning need to run?
SKILL.md names no scripts, command-line tools or credentials: Planning is instructions for the agent only.
Does Planning access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Planning safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Planning use?
No licence was found for Planning or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.
How many tokens does Planning use?
About 779 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Planning?
Skills that share tags, products or a category with Planning: Plannotator Annotate (backnotprop/plannotator, 9.3k stars), Plannotator Visual Explainer (backnotprop/plannotator, 9.3k stars), Create Skill (PINA-org/PINA, 798 stars) and Writing Docs (c15t/c15t, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Planning?
championswimmer (a GitHub user) maintains it in championswimmer/pi-context-prune, which has 245 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on September 30, 2026.
Source: championswimmer/pi-context-prune on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.