create-a-big-plan
Create a large Prime Agent plan before implementation. Use for open-ended or high-risk repo efforts needing 10 or more planning…
@optim-agentInstall SkillDevelopment
Skill
/create-a-plan
Create a researched Prime Agent plan before implementation. Use for broad or risky repo changes needing 5 to 10 planning questions, web research, reviewer or criticizer settings, and bounded refinement; exclude direct implementation-only, factual/explanation, trivial
Claude Code
$ npx -y skills add Optim-Agent/optim-plans --skill create-a-plan --agent claude-code
Codex
$ npx skills add Optim-Agent/optim-plans --skill create-a-plan -a codex -y
Cursor
$ npx skills add Optim-Agent/optim-plans --skill create-a-plan -a cursor -y
Gemini CLI
$ npx skills add Optim-Agent/optim-plans --skill create-a-plan -a gemini-cli -y
GitHub Copilot
$ npx skills add Optim-Agent/optim-plans --skill create-a-plan -a github-copilot -y
OpenCode
$ npx skills add Optim-Agent/optim-plans --skill create-a-plan -a opencode -y
Windsurf
$ npx skills add Optim-Agent/optim-plans --skill create-a-plan -a windsurf -y
SKILL.md
create-a-plan.SKILL.mdname: create-a-plan
description: Create a researched Prime Agent plan before implementation. Use for broad or risky repo changes needing 5 to 10 planning questions, web research, reviewer or criticizer settings, and bounded refinement; exclude direct implementation-only, factual/explanation, trivial command-only, or explicit no-plan requests.
Create A Plan
Use this skill when the user wants a substantive plan before a repository change.
Setup
1. Read `../_shared/references/prime-planning-workflow.md`, `../_shared/references/state-and-config.md`, and `../_shared/references/plan-artifact-template.md`. 2. Initialize state with `python3 scripts/optim_plans.py init --repo <target-repo> --topic <topic> --plan-level create-a-plan --request-text <original-request>`. 3. Use `.git/optim-plans` for controller state and `docs/optim-plans/YYYY-MM-DD-topic/` for public artifacts.
Depth Contract
- Inspect the target Git repo read-only before the first product question.
- Ask 5 to 10 planning questions, one at a time.
- Use web research during brainstorming whenever outside library behavior, ecosystem precedent, UX convention, protocol semantics, or compatibility affects the recommendation.
- Use the standard choice prompt format: recommended first, `Other` second-last, `Auto-complete` last.
- Ask the mandatory final scope confirmation before writing `PLAN_v1.md`.
- Write `PLAN_v1.md` under `docs/optim-plans/YYYY-MM-DD-topic/`.
- Run up to five refinement rounds. Continue only for high-priority reviewer findings or unresolved criticizer questions.
- In each refinement round, surface at most five high-priority comments or questions.
- After convergence or user acceptance, ask the native execution handoff question without `Auto-complete`.
Fit
Choose this level for multi-file changes, architecture boundaries, user-facing workflows, external APIs, dependency upgrades, compatibility risk, or cases where web evidence should shape the plan.
Escalate to `create-a-big-plan` when the problem is open-ended, cross-system, strategically ambiguous, or likely to require more than ten planning decisions.
Read more
name: create-a-plan description: Create a researched Prime Agent plan before implementation. Use for broad or risky repo changes needing 5 to 10 planning questions, web research, reviewer or criticizer settings, and bounded refinement; exclude direct implementation-only, factual/explanation, trivial command-only, or explicit no-plan requests.
Create A Plan
Use this skill when the user wants a substantive plan before a repository change.
Setup
1. Read `../_shared/references/prime-planning-workflow.md`, `../_shared/references/state-and-config.md`, and `../_shared/references/plan-artifact-template.md`. 2. Initialize state with `python3 scripts/optim_plans.py init --repo <target-repo> --topic <topic> --plan-level create-a-plan --request-text <original-request>`. 3. Use `.git/optim-plans` for controller state and `docs/optim-plans/YYYY-MM-DD-topic/` for public artifacts.
Depth Contract
- Inspect the target Git repo read-only before the first product question.
- Ask 5 to 10 planning questions, one at a time.
- Use web research during brainstorming whenever outside library behavior, ecosystem precedent, UX convention, protocol semantics, or compatibility affects the recommendation.
- Use the standard choice prompt format: recommended first, `Other` second-last, `Auto-complete` last.
- Ask the mandatory final scope confirmation before writing `PLAN_v1.md`.
- Write `PLAN_v1.md` under `docs/optim-plans/YYYY-MM-DD-topic/`.
- Run up to five refinement rounds. Continue only for high-priority reviewer findings or unresolved criticizer questions.
- In each refinement round, surface at most five high-priority comments or questions.
- After convergence or user acceptance, ask the native execution handoff question without `Auto-complete`.
Fit
Choose this level for multi-file changes, architecture boundaries, user-facing workflows, external APIs, dependency upgrades, compatibility risk, or cases where web evidence should shape the plan.
Escalate to `create-a-big-plan` when the problem is open-ended, cross-system, strategically ambiguous, or likely to require more than ten planning decisions.
Ships withoptim-plans
Human-in-the-loop planning plugin for Claude and Codex: turn ideas into reviewed Markdown plans, record decisions, enforce explicit execution gates, and provide tested controller primitives for safer agent workflows.
35 skills
Stars on GitHub
Momentum
- stars in total
- 3
Other skills on optim-plans.
@optim-agentInstall Skillcreate-a-small-plan
Create a small Prime Agent plan before implementation. Use for small scoped repo changes needing 1 to 3 planning questions and…
@optim-agentInstall Skilldiagnose-before-plan
Diagnose failures before creating a Prime Agent plan. MUST USE for bugs, CI failures, test failures, regressions, incidents,…
@optim-agentInstall Skillreference-before-plan
Research references before creating a Prime Agent plan. Use when repo-change planning needs downloaded projects, articles,…
@optim-agentInstall SkillMore skills from other plugins.
Auto-invoked
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
@obraInstall Skillask-matt
Ask which skill or flow fits your situation. A router over the skills in this repo.
@mattpocockInstall SkillAuto-invoked
Questions about create-a-plan.
- Which coding agents can use create-a-plan?
- create-a-plan installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.