implementation-plan skill
Write an implementation plan that leads with the decisions the user is most likely to change, and buries the mechanical work at the bottom. Use when planning is requested before a build, especially after brainstorming or an interview.
- GitHub stars
- 372
- Files
- 1
- Last commit
- Sep 28, 2026
- License
- MIT
- Allowed tools
- —
What does the implementation-plan skill do?
implementation-plan writes an implementation plan that leads with the decisions the user is most likely to change, and buries the mechanical work at the bottom. Use when planning is requested before a build, especially after brainstorming or an interview.
How to install the implementation-plan skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the implementation-plan skill in Plugin
/plugin marketplace add Neeeophytee/finding-unknowns-skills /plugin install finding-unknowns@finding-unknowns-skills
Install the implementation-plan skill in Claude Code
~/.claude/skills/implementation-plan/SKILL.md
$ npx degit Neeeophytee/finding-unknowns-skills/skills/implementation-plan ~/.claude/skills/implementation-planInstall the implementation-plan skill in Claude Code (project)
.claude/skills/implementation-plan/SKILL.md
$ npx degit Neeeophytee/finding-unknowns-skills/skills/implementation-plan .claude/skills/implementation-planInstall the implementation-plan skill in Codex
~/.agents/skills/implementation-plan/SKILL.md
$ npx degit Neeeophytee/finding-unknowns-skills/skills/implementation-plan ~/.agents/skills/implementation-planInstall the implementation-plan skill in Gemini CLI
~/.gemini/skills/implementation-plan/SKILL.md
$ npx degit Neeeophytee/finding-unknowns-skills/skills/implementation-plan ~/.gemini/skills/implementation-planInstall the implementation-plan skill in Claude.ai
npx degit Neeeophytee/finding-unknowns-skills/skills/implementation-plan implementation-plan && zip -r implementation-plan.zip implementation-plan # claude.ai → Customize → Skills → + → Create skill → Upload a skill → implementation-plan.zip
SKILL.md
View on GitHubImplementation plan
A plan's job is not to prove you thought of everything. It's to put the reversible-but-expensive decisions in front of the user while changing them is still free. Order the plan by likelihood-of-tweaking, not by build order.
Steps
- Open with a three-line summary: what is being built, the approach chosen, and the single riskiest assumption.
- Section 1 — Decisions you'll probably want to tweak. Data model changes, new type interfaces, API shapes, anything user-facing. For each: the choice made, one alternative considered, and what changing it later would cost.
- Section 2 — Known unknowns and how the plan absorbs them. Where ambiguity remains, state the default that will be taken and the signal that would trigger a pivot. A plan that admits its unknowns survives contact with the territory; one that doesn't just breaks quietly.
- Section 3 — The mechanical work. Refactors, wiring, migrations, tests. Compress this; the user trusts you here and reviewing it is a waste of their attention.
- End with the review request: the 2-4 specific items you want a yes/no or a pick on before starting.
- If the plan is more than a screenful or the user prefers visual artifacts, offer it as a single self-contained HTML page — sections collapsible, tweakable decisions pinned to the top.
Guardrails
- If a genuinely better approach appears mid-planning, present the pivot as its own decision — don't silently re-plan.
- Keep it reviewable in minutes. A plan too long to read gets skimmed, and skimmed plans hide bad decisions.
- The plan should leave room for improvisation during implementation; over-specified plans fail exactly where the territory disagrees with the map.
Files in this skill
1implementation-plan skill questions
How do I install the implementation-plan skill in Claude Code?
Run npx degit Neeeophytee/finding-unknowns-skills/skills/implementation-plan ~/.claude/skills/implementation-plan. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the implementation-plan skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.