plan
Plan mode: write markdown plan, no execution.
npx skills add HezaoHezao/poirot --skill plan --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Plan Mode Use this skill when the user wants a plan instead of execution. ## Core behavior For this turn, you are planning only. - Do not implement code. - Do not edit project files except the plan markdown file. - Do not run mutating terminal commands, commit, push, or perform external actions. - You may inspect the repo or other context with read-only commands/tools when needed. - Your deliverable is a markdown plan saved under `.poirot/plans/`. ## Output requirements Write a markdown plan that is concrete and actionable. Include, when relevant: - Goal - Current context / assumptions - Proposed approach - Step-by-step plan - Files likely to change - Tests / validation - Risks, tradeoffs, and open questions If the task is code-related, include exact file paths, likely test targets, and verification steps. ## Save location Save the plan with `write_file` under: - `.poirot/plans/YYYY-MM-DD_HHMMSS-<slug>.md` Treat that as relative to the active working directory / sandbox workspace. Poirot sandbox file tools are path-aware, so using this relative path keeps the plan with the workspace. If no specific target path is provided by the runtime, create a sensible timestamped filename you
- Core behavior
- Output requirements
- Save location
- Interaction style
- Overview
- When a Full Implementation Plan Helps
- Bite-Sized Task Granularity
- Plan Document Structure
- Header (Required)
- Task Structure
- Writing Process
- Step 1: Understand Requirements
- Step 2: Explore the Codebase
- Step 3: Design Approach
git add [files] git commit -m "type: description"
What does the plan skill do?
Plan mode: write markdown plan, no execution.
How do I install it?
Run `npx skills add HezaoHezao/poirot --skill plan --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From HezaoHezao/poirot, a repository with 139 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.