MCPInstall

plan

Use this skill when decomposing complex work into verifiable tasks and dependencies before or during implementation. Activates on mentions of write a plan, create a plan, break this down, task decomposition, implementation plan, what are the steps, plan the work, spec this out, or decompose this feature.

Installs
604
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/hyperb1iss/hyperskills --skill plan
  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 plan 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.

Structured Planning

Build a plan that another session can execute and verify without rediscovering the decision. Specify outcomes and dependencies tightly enough to prevent drift while leaving implementation choices to the code and evidence encountered during execution.

The user's instructions take precedence over this skill's guidelines. Planning does not add an approval requirement. If execution is already authorized, continue after the plan is ready; if the user requested only a plan, deliver the plan without starting implementation.

Size the Plan by Uncertainty

Work shapePlanning depth
Clear, reversible change with a direct checkExecute with a brief mental or inline plan
Several dependent behaviors with known patternsRecord tasks, interfaces, and acceptance checks
Uncertain architecture or migrationResolve decisive unknowns and plan a representative vertical slice
Work spanning agents, sessions, or environmentsPreserve ownership, state, dependencies, and resumption instructions

File count is a poor proxy for risk. A one-line authorization change can need more analysis than a mechanical rename across many files. Plan enough to expose the uncertain or irreversible parts, not enough to predict every edit.

Establish the Actual Starting Point

Inspect repository status, relevant diffs, and the code path under discussion. Locate an existing implementation pattern and the real verification commands in scripts, hooks, or CI. Read relevant project memory through the installed Sibyl skill when configured.

Record the facts that constrain execution:

  • The observable user or system outcome.
  • The current baseline and revision or environment being inspected.
  • The interfaces, ownership, and compatibility obligations affected.
  • The uncertainty that could invalidate the proposed work.
  • The explicit constraints, non-goals, and user corrections.

Treat an inherited plan as a hypothesis. Recheck consequential claims against the current tree before executing them. Distinguish verified facts, assumptions awaiting a check, and obsolete premises. Update the plan itself when a premise fails; a detached comment leaves the executor following stale instructions.

Choose a Useful Slice

Look for existing capabilities that can satisfy the request before decomposing a new mechanism. Simplification must preserve the requested result. Do not replace a difficult product goal with a convenient demonstration of plumbing.

Prefer a vertical slice through the uncertain boundary when it can prove feasibility early: a real input passing through the changed logic to the consumer that needs it. Plan migrations around compatibility and deployment order. Source-file order does not determine safe rollout order.

Keep implementation and its behavioral verification in the same accountable task. A title containing "and" is not evidence that the task should split. Separate tasks when they have independently reviewable outcomes, distinct owners, or real dependency boundaries. A test-infrastructure prerequisite may be separate; feature tests should not become an orphaned follow-up.

Give Each Task an Executable Contract

Use only the fields the task needs:

FieldContent
OutcomeThe behavior or artifact delivered
ScopeKnown files/modules and permitted expansion rules
DependenciesRequired inputs or interfaces, with their producer
VerificationExact runnable check plus the behavior it proves
Completion evidenceExpected artifact, assertion, observation, or report
Risk and recoveryCompatibility, rollback, or unresolved external dependency when material

Example:

### Task: Reject expired sessions at the request boundary

Outcome: An expired session receives the established unauthorized response.
Scope: The session validator and its request-level tests.
Depends on: The existing clock injection interface, confirmed in the repo.
Verify: [repository's exact focused test command].
Cases: Expired, valid, and boundary-time sessions preserve expected behavior.
Completion: Tests exercise the request path and report executed cases.

Prefer real file paths where known; label proposed paths instead of pretending exploration is complete. A copyable command still needs an assertion: "renders" does not prove that the generated policy matches the intended resources.

Map Dependencies and Ownership

Parallelize independent outcomes. File separation helps avoid collisions but does not prove independence: two modules can share a schema, generated file, test database, port, or output directory. Name those shared resources and their owners.

Choose dependency-ready work rather than forcing every task into synchronized waves. A wave is useful when tasks share a meaningful integration checkpoint. Designate an integration owner and verify combined behavior after branches or patches meet. Consult orchestrate when delegation adds useful capacity and current instructions permit it.

Review the plan for missing consumers, incompatible rollout states, and unnecessary scope. For consequential architecture or policy, seek independent critique when required or justified. Keep the review aimed at unresolved decisions. More rounds are useful only when new evidence or concrete defects improve the plan; disagreement alone does not justify endless revision.

Make the Plan Resumable

Use the project's canonical tracker or agreed artifact location. With Sibyl, use its installed skill for current task and memory commands. Avoid duplicating the full plan in chat, repository files, and memory; select one authoritative plan and link to it from the tracker.

Do not create or commit planning documents merely because work spans sessions. Follow repository rules about scratch files and planning artifacts. If a document is required, place it where future agents can actually access it, and include untracked context in delegated briefs when their checkouts will not contain it.

A useful checkpoint records the current revision, completed outcomes and evidence, active ownership, pending decisions, and exact next step. Preserve user corrections that would otherwise be lost during compaction. Re-read the checkpoint and inspect live state on resumption; notes describe a past state, not a guarantee of the current one.

Replan Without Losing the Goal

When implementation exposes a new constraint, change the affected tasks and explain its impact on the outcome, dependencies, or risk. Carry corrections through tables and acceptance criteria, not just the edited paragraph. Preserve rejected alternatives only when their rationale helps future decisions.

At integration boundaries, compare the accumulated diff with the intended outcome. Tests can pass while scope drifts. Review intensity follows changed risk and coverage, not task number or how many earlier tasks passed. Mandatory project verification still applies to late work.

Mark completed work only when the required evidence exists. Report an unavailable external gate separately from completed local checks, with its exact blocker and next action. Follow the host's task-state rules when recording blocked status; this skill does not redefine them.

Evidence and Limits

Reviewed 2026-09-04. Anthropic's March 2026 harness report describes outcome-oriented specifications and negotiated verification criteria, while observing that repeated evaluation can also increase implementation complexity. It is an engineering case study, not proof that every project needs a planner-generator-evaluator pipeline.

The procedures here use that distinction: preserve a testable contract and adapt the execution path. Evaluate planning changes through resulting work and correction cost, not the size of the plan.

Anti-Patterns

Anti-patternBetter move
Exact edit predictions before reading codeSpecify verified boundaries and uncertain details
Separate every feature from its testsKeep one owner accountable for delivered behavior
Parallelize based only on filenamesInspect shared interfaces and runtime resources
Demand approval after authorization to buildContinue within the existing scope
Ease review because the task is lateMatch review to current risk and evidence
Maintain several competing progress ledgersKeep one authoritative plan with linked receipts
Keep decomposing after success is coveredExecute; replan when evidence changes the work

What This Skill is NOT

  • A requirement for trivial work or a fixed file-count threshold.
  • Permission to execute a plan-only request.
  • A promise that an initial architecture, schedule, or task list cannot change.

FAQ

What does the plan skill do?

Use this skill when decomposing complex work into verifiable tasks and dependencies before or during implementation. Activates on mentions of write a plan, create a plan, break this down, task decomposition, implementation plan, what are the steps, plan the work, spec this out, or decompose this feature.

How do I install plan?

Run npx skills add https://github.com/hyperb1iss/hyperskills --skill plan 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/plan/ (personal) or .claude/skills/plan/ (project).

Which AI agents can use plan?

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 plan 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 plan?

It is published by hyperb1iss in hyperb1iss/hyperskills. It has 604 recorded installs.

More from hyperb1iss/hyperskills

View all →

tui-design

hyperb1iss/hyperskills

Use this skill when designing terminal user interfaces, creating TUI layouts, choosing TUI color schemes, implementing keyboard navigation, building terminal dashboards, or working with any TUI framework. Activates on mentions of TUI design, terminal UI, Ratatui layout, Ink components, Textual widgets, Bubbletea views, terminal color palette, keybinding design, panel layout, split panes, terminal dashboard, box-drawing characters, sparklines, progress bars, modal dialogs, focus management, or terminal accessibility.

Frontend & Design1.3K installs

orchestrate

hyperb1iss/hyperskills

Use this skill when coordinating independent agents with explicit ownership, dependencies, integration, and verification. Activates on mentions of swarm, parallel agents, multi-agent, orchestrate, fan-out, wave dispatch, research army, unleash, dispatch agents, or parallel work.

AI & Agents668 installs

research

hyperb1iss/hyperskills

Use this skill when gathering and evaluating evidence for a technical decision, SOTA analysis, or codebase investigation. Activates on mentions of research, investigate, evaluate options, what's the best, compare alternatives, state of the art, deep dive, explore the landscape, or find out how.

codex-review

hyperb1iss/hyperskills

Use this skill for code reviews using the Codex CLI from a Claude-hosted session. Activates on mentions of codex review, code review with codex, codex check, gpt review, codex exec review, run codex, review my code, review this PR, review changes, peer review, or second opinion.

brainstorm

hyperb1iss/hyperskills

Use this skill when exploring an open product or architecture question before choosing an approach. Activates on mentions of brainstorm, ideate, design session, explore options, what should we build, how should we approach, let's think about, new project, architecture decision, or design exploration. Skip it for a clear implementation request.

implement

hyperb1iss/hyperskills

Use this skill when writing code, building features, fixing bugs, refactoring, or performing multi-step implementation work. Activates on mentions of implement, build this, code this, start coding, fix this bug, refactor, make changes, develop this feature, coding task, write the code, or start building.

Popular code quality & workflow skills

View category →

grill-me

mattpocock/skills

A relentless interview to sharpen a plan or design.

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

handoff

mattpocock/skills

Compact the current conversation into a handoff document for another agent to pick up.

domain-modeling

mattpocock/skills

Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.

codebase-design

mattpocock/skills

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

diagnosing-bugs

mattpocock/skills

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.