Agent skill

Make A Plan

by penpot in penpot/penpot

Planning flow — research the subject of this session, produce an implementation plan with the planner skill, resolve open questions with the user in plain language, and save the final plan to…

MPL-2.0Auto-check passedAgent Workflows

Install Make A Plan

skills CLI
$ npx skills add penpot/penpot --skill make-a-plan -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install penpot/penpot make-a-plan --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/penpot/penpot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/make-a-plan .claude/skills/make-a-plan && rm -rf skills-src

Use ~/.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/

Facts

Skill name
make-a-plan
GitHub stars
61k
Token cost
~1.6k tokens
SKILL.md length
932 words
Files
1
Skills in repo
24
Repo updated
First seen
Licence
MPL-2.0

At a glance

Planning flow — research the subject of this session, produce an implementation plan with the planner skill, resolve open questions with the user in plain language, and save the final plan to…

  • Works in 4 steps: Produce the plan with the planner skill.… → Before asking me to decide anything,… → Once all decisions are answered and the… → …
  • Tasks that involve Planning
  • SKILL.md covers When to use, Instructions and User input, overrides and…
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Make A Plan is an agent skill from penpot/penpot. Planning flow — research the subject of this session, produce an implementation plan with the planner skill, resolve open questions with the user in plain language, and save the final plan to .agents/plans/.

Its SKILL.md is about 1.6k 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 Planning and Plain language and style rules. The repository describes itself as: Penpot: The open-source design platform for Product teams that need scalable collaboration. The licence is MPL-2.0.

When your agent uses it

  • Tasks that involve Planning
  • Tasks that involve Plain language and style rules

Example prompts

  • “/make-a-plan”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Produce the plan with the planner skill. By default, research the
  2. Before asking me to decide anything, explain the plan and every open question in
  3. Once all decisions are answered and the plan is final, save it verbatim to the
  4. Present me with a clear, self-contained summary of the plan's most relevant points

What it can do on your machine

Read from SKILL.md and the folder at commit cb1118f. 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.

    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

Make A Plan loads about 1.6k tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 932 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~55
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

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

The full file from penpot/penpot at commit cb1118f, republished under its MPL-2.0 licence (© penpot). 932 words, ~1,552 tokens.

Download SKILL.mdSave it as .claude/skills/make-a-plan/SKILL.md (or your agent's skills folder).
name
make-a-plan
description
Planning flow — research the subject of this session, produce an implementation plan with the planner skill, resolve open questions with the user in plain language, and save the final plan to .agents/plans/.
slash
true

Make a Plan

Act as a senior software engineer: research the subject of this session in depth and produce a well-grounded, actionable implementation plan.

If the running agent cannot write (for example, the plan agent), say so and stop — this skill needs the build agent to save the plan.

When to use

  • The user asks to plan, design, or break down a task, in any phrasing: "make a plan", "how would we build X", "design an approach for Y" — or runs /make-a-plan.
  • The user asks to rework or extend an existing plan. While the plan is still unimplemented (pre-implement-plan iteration, e.g. after /review-plan findings or user feedback), revise the saved plan file in place. Once the plan has been implemented and reviewed (post /review-code findings on committed work), write a new derived plan file instead — never rewrite the executed plan. The planner skill defines the derived naming (--review-NN, --task-NN).
  • The user says to apply review-plan findings to a still-unimplemented plan: apply the agreed changes, flip Status to reviewed, and append one UTC ISO 8601 line to Review Log describing what changed. This apply step is the only pre-implementation write to those fields — review-plan itself stays read-only and never writes.

Do not use it to execute a plan — that is the implement-plan flow.

Instructions

  1. Produce the plan with the planner skill. By default, research the subject of this session and draft the plan yourself. If I ask for it (for example, delegated in the user context), delegate to the general subagent instead — the delegate must also follow the planner skill and receive all the relevant session context (a review, user feedback, and so on).
  2. Before asking me to decide anything, explain the plan and every open question in plain language. Assume I know only the high-level project goal, not the codebase, architecture, implementation terms, or the problem this task solves.
  3. Once all decisions are answered and the plan is final, save it verbatim to the announced path under .agents/plans/ (create the directory if it does not exist). This step is the flow's explicit authorization to write the plan file — the only write allowed here. A fresh plan uses .agents/plans/YYYY-MM-DD-<slug>.md with Status: draft and an empty Review Log; a derived plan uses the parent basename plus the planner suffix (--review-NN, --task-NN) in its own new file, also starting as draft. If I later ask for changes to a still-unimplemented plan, update the saved file directly.
  4. Present me with a clear, self-contained summary of the plan's most relevant points only after all required decisions have been answered. Write it for someone who knows only the project's high-level goal and may not know the plan's low-level context. Explain necessary technical language in plain terms, include the problem being solved and the proposed outcome, and do not assume that listing technical task names is enough.
Show full SKILL.md (458 more words)Show less
Hard rule — read-only while planning

While this flow runs, act read-only: research with read-only tools only. Never edit source files, never run builds, tests, linters, or any command that modifies state, and never commit. The single allowed write is the plan file in step 3. This rule expires when I approve the plan or move on to another task; then you act as a normal build agent again.

When the plan contains open questions, do not show them as bare technical questions or assume that I understand the technical language or technical words used in the plan. For each question, first explain:

  • What part of the user problem the decision affects.
  • The relevant concept from the beginning, with a small concrete example.
  • What each available option would make the system do.
  • The practical benefits, costs, risks, and user-visible consequences of each option.
  • Which option the planner recommends and why.

Only after that explanation, use the question tool to ask the decision with clear, non-technical option labels. Put the recommended option first and mark it as (Recommended). Group related questions when their context is shared, but do not ask a question whose meaning has not already been explained.

If I say that I do not understand a question or its choices, do not treat my previous answer as valid. Explain the concepts again from the high-level project goal, use a more concrete example, explain the implications, and ask the question again with the question tool. Repeat this until I can make an informed choice. If one answer creates new design consequences or additional decisions, explain those consequences before asking any new question.

Distinguish clearly between requirements already fixed by the roadmap or existing architecture and choices that actually require my input. Do not ask me to choose an implementation detail when the plan can resolve it safely without changing the public behavior. If there are no decisions that require my input, say so and present the summary.

IMPORTANT: Under no circumstances execute the plan. Wait for the user to review it after all possible questions have been answered. The final summary must explain the problem being solved, the proposed behavior, the main user-visible workflow, important constraints and risks, what is deliberately out of scope, and the path where the plan is saved. Never assume that a short list of task names is enough context. End the final response by suggesting the next steps, in this order:

  1. /review-plan — to get a second opinion on the plan before executing it.
  2. /implement-plan — to execute the plan from the current session context.

These are suggestions, not a required pipeline — any instruction from me overrides them (for example, asking you to implement the plan directly).

User input, overrides and additional context

$ARGUMENTS

© penpot, MPL-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/make-a-plan of penpot/penpot.

Open the folder on GitHubat commit cb1118f

Compare with similar skills

Make A Plan 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.

Make A Plan compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Make A Plan this skillpenpot/penpot61k—~1.6kAutomated safety check: PassMPL-2.0
Stakeholder Summarytestdouble/han279—~6.3kAutomated safety check: PassMIT
Audit Session Metricscentminmod/my-claude-code-setup2.7k—~2.1kAutomated safety check: PassMIT
Ponylang Prose Reviewponylang/ponylang-website160—~2.9kAutomated safety check: PassBSD-2-Clause
Inherit Legacy Styleaffaan-m/ECC275k1 repos~2.1kAutomated safety check: NotesMIT
Coco Loopcoco-research/coco482—~1.4kAutomated safety check: PassProprietary

Similar skills

  • Stakeholder Summary

    testdouble/han

    Produces a plain-language stakeholder summary from an existing feature specification, for sharing with non-technical stakeholders before implementation kicks off.

    279 GitHub stars~6.3k tokensUpdated 6 days ago
    Writing & ContentAuto-check passed
  • Audit Session Metrics

    centminmod/my-claude-code-setup

    Audit a session-metrics JSON export for token-usage waste and produce a plain-English findings report.

    2.7k GitHub stars~2.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Ponylang Prose Review

    ponylang/ponylang-website

    Ensemble review of ponylang blog and Last Week in Pony prose.

    160 GitHub stars~2.9k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed
  • Prevent AI style drift on legacy projects by scanning the codebase for implicit conventions, resolving conflicts with the operator one at a time, and writing an enforceable .ai-style-rules.md…

    275k GitHub starsUsed in 1 repo~2.1k tokens
    Agent WorkflowsAuto-check: notes
  • Coco Loop

    coco-research/coco

    Start a safe, governed autonomous loop from a plain-language goal.

    482 GitHub stars~1.4k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Talk Normal

    hexiecs/talk-normal

    Installs an always-on set of rules into your agent's workspace config that cuts filler, hedging and padded closings from its replies.

    1.9k GitHub stars~784 tokensUpdated 5 mo ago
    Agent WorkflowsAuto-check passed

More from penpot/penpot

All 24 skills in this repo
  • Hardens code against vulnerabilities. An agent skill from penpot/penpot.

    61k GitHub starsUsed in 6 repos~4.7k tokens
    Auto-check: notes
  • Bat Cat

    penpot/penpot

    A cat clone with syntax highlighting, line numbers, and Git integration - a modern replacement for cat.

    61k GitHub starsUsed in 3 repos~1.1k tokens
    Auto-check passed
  • Create PR

    penpot/penpot

    PR flow — open a new PR for the current task branch (validates base branch, commits, issue and push state) or update an existing PR's title or description to match Penpot conventions.

    61k GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Local CI

    penpot/penpot

    Run local CI-style checks with ./scripts/ci (lint, tests, format) per monorepo module.

    61k GitHub stars~822 tokensUpdated today
    Auto-check passed
  • Ste

    penpot/penpot

    Write or rewrite text in ASD-STE100 Simplified Technical English.

    61k GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Code review criteria — the five review axes, core principles, severity format, and verdict for reviewing code changes.

    61k GitHub stars~3.6k tokensUpdated today
    Auto-check passed

Questions about Make A Plan

What does Make A Plan do?

Planning flow — research the subject of this session, produce an implementation plan with the planner skill, resolve open questions with the user in plain language, and save the final plan to…. Make A Plan is an agent skill from penpot/penpot.agents/plans/.

When should I use Make A Plan?

Make A Plan fits situations like: tasks that involve Planning; tasks that involve Plain language and style rules.

How do I install Make A Plan in Claude Code?

Run `npx skills add penpot/penpot --skill make-a-plan -a claude-code`. Or copy the skill folder (.agents/skills/make-a-plan in penpot/penpot) into .claude/skills/make-a-plan in your project. Claude Code loads it when a task matches its description.

How do I install Make A Plan in Codex?

Run `npx skills add penpot/penpot --skill make-a-plan -a codex`. Or copy the skill folder (.agents/skills/make-a-plan in penpot/penpot) into .agents/skills/make-a-plan in your project. Codex loads it when a task matches its description.

Can I use Make A Plan 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 penpot/penpot --skill make-a-plan -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/make-a-plan, .gemini/skills/make-a-plan, .github/skills/make-a-plan and .opencode/skills/make-a-plan in your project.

What does Make A Plan need to run?

SKILL.md names no scripts, command-line tools or credentials: Make A Plan is instructions for the agent only.

Does Make A Plan 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 Make A Plan 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 Make A Plan use?

Make A Plan is published under the MPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Make A Plan use?

About 1.6k tokens (SKILL.md is roughly 6.2k 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 Make A Plan?

Skills that share tags, products or a category with Make A Plan: Stakeholder Summary (testdouble/han, 279 stars), Audit Session Metrics (centminmod/my-claude-code-setup, 2.7k stars), Ponylang Prose Review (ponylang/ponylang-website, 160 stars) and Inherit Legacy Style (affaan-m/ECC, 275k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Make A Plan?

penpot (a GitHub organization) maintains it in penpot/penpot, which has 60,798 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 7, 2026.

Source: penpot/penpot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.