Agent skill

Plan Project

by mattolson in mattolson/agent-sandbox

Create a project plan for a new initiative. An agent skill from mattolson/agent-sandbox.

MITAuto-check passedProduct & Project Management

Install Plan Project

skills CLI
$ npx skills add mattolson/agent-sandbox --skill plan-project -a claude-code

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

GitHub CLI
$ gh skill install mattolson/agent-sandbox plan-project --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/mattolson/agent-sandbox.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/plan-project .claude/skills/plan-project && 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
plan-project
GitHub stars
208
Token cost
~1.1k tokens
SKILL.md length
479 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

Create a project plan for a new initiative. An agent skill from mattolson/agent-sandbox.

  • Works in 6 steps: Problem Definition → Solution Exploration → Technical Due Diligence → …
  • Starting a new project
  • SKILL.md covers Output, Process and Project Plan Template
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Plan Project is an agent skill from mattolson/agent-sandbox. Create a project plan for a new initiative. Use when starting a new project, defining goals, breaking work into milestones, and doing initial technical due diligence.

Its SKILL.md is about 1.1k 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 Product & Project Management, covering Project management and Fundraising and pitch decks. The repository describes itself as: Secure local dev environment for collaboration with AI coding agents. The licence is MIT.

When your agent uses it

  • Starting a new project
  • Breaking work into milestones
  • Doing initial technical due diligence

Example prompts

  • “/plan-project”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Problem Definition
  2. Solution Exploration
  3. Technical Due Diligence
  4. Architecture Sketch
  5. Rollout Planning
  6. Milestone Breakdown

What it can do on your machine

Read from SKILL.md and the folder at commit c5b65e7. 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 (its code samples are markdown).

    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

Plan Project loads about 1.1k tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 479 words of instructions outside code blocks.

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

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 mattolson/agent-sandbox at commit c5b65e7, republished under its MIT licence (© mattolson). 479 words, ~1,148 tokens.

Download SKILL.mdSave it as .claude/skills/plan-project/SKILL.md (or your agent's skills folder).
name
plan-project
description
Create a project plan for a new initiative. Use when starting a new project, defining goals, breaking work into milestones, and doing initial technical due diligence.

Project Planning

Part of the three-tier planning system. See /plan for an overview.

This skill guides the creation of a high-level project plan. The output defines goals, approach, architecture, and milestones. It is intentionally broad; detailed planning happens later during milestone planning and task planning as work progresses.

Output

The final artifact is docs/plan/project.md.

The project plan can be updated as work progresses. When significant changes are made, update the plan to reflect current state and always create a decision record in docs/plan/decisions/. The decision records serve as the history of how the plan evolved.

Process

Work through these phases interactively with the user. Do not rush ahead. Each phase should be a conversation.

Phase 1: Problem Definition

Clarify what we're building and why.

  • What problem are we solving?
  • Who is it for?
  • What does success look like?
  • What are the constraints (resources, technical, organizational)?
  • What direct requests have come from customers or potential users?
  • What are their stated requirements vs. underlying needs?

Capture answers in a working draft. Confirm understanding before proceeding.

Phase 2: Solution Exploration

Explore the solution space before committing to an approach.

  • What are the possible approaches?
  • What are the tradeoffs of each?
  • Are there existing solutions or prior art to consider?
  • What technologies or patterns are candidates?

Document options considered, not just the chosen path.

Phase 3: Technical Due Diligence

Identify risks and unknowns early.

  • What are the biggest technical unknowns?
  • Are there feasibility concerns that need validation?
  • What dependencies exist (external services, APIs, libraries)?
  • What could go wrong?

Flag items that need spikes or proof-of-concept work.

Show full SKILL.md (217 more words)Show less
Phase 4: Architecture Sketch

Outline how the pieces fit together. Focus on decisions that are hard to reverse, affect milestone boundaries, or require early validation.

  • What are the major components?
  • How do they interact?
  • What are the key interfaces or boundaries?
  • What data flows through the system?
  • What decisions are hard to change later (data models, public APIs, core abstractions)?

Leave internal implementation details for milestone and task planning. The goal is knowing enough to draw milestone boundaries correctly and flag what needs early de-risking.

Phase 5: Rollout Planning

For modifications to existing systems, define how to deploy safely.

  • Is this a new system or a modification to an existing one?
  • What is the migration path for existing users or data?
  • Can changes be rolled out incrementally (feature flags, canary, percentage rollout)?
  • What is the rollback plan if something goes wrong?
  • Are there dependencies on external teams or systems for rollout?

Skip this phase for greenfield projects with no existing users.

Phase 6: Milestone Breakdown

Divide the work into logical chunks.

  • What are the natural phases of delivery?
  • What can be delivered incrementally?
  • What are the dependencies between milestones?
  • What is the rough sequence?

Each milestone should have a clear goal and boundary.

Project Plan Template

When all phases are complete, compile into docs/plan/project.md using this structure:

markdown
# Project: {Name}

## Problem Statement

{What problem are we solving and why}

## User Requirements

{Direct requests and requirements from customers or potential users}

## Success Criteria

{How we'll know we succeeded}

## Constraints

{Resources, technical, organizational limitations}

## Approach

{Chosen approach and rationale}

### Alternatives Considered

{Other options explored and why they were not chosen}

### Literature Review

{Links to similar systems, architectures, or prior art reviewed during planning. Include brief notes on what was learned from each.}

## Architecture Overview

{High-level description of components and how they interact}

## Technical Risks

{Unknowns, feasibility concerns, dependencies}

## Rollout Plan

{Migration path, incremental rollout strategy, rollback plan. Omit for greenfield projects.}

## Milestones

### Milestone 1: {Name}

{Goal and scope}

### Milestone 2: {Name}

{Goal and scope}

{Continue as needed}

## Open Questions

{Anything unresolved that needs future attention}

© mattolson, MIT. 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/plan-project of mattolson/agent-sandbox.

Open the folder on GitHubat commit c5b65e7

Compare with similar skills

Plan Project 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.

Plan Project compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Plan Project this skillmattolson/agent-sandbox208—~1.1kAutomated safety check: PassMIT
Ceos Calendarbradfeld/ceos154—~2kAutomated safety check: PassMIT
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Uvastral-sh/claude-code-plugins3142 repos~980Automated safety check: PassApache-2.0
Project Managementkunchenguid/firstmate7.6k—~2.1kAutomated safety check: PassMIT
Hivemind Goalsactiveloopai/hivemind1.6k—~1.7kAutomated safety check: NotesApache-2.0

Similar skills

  • Ceos Calendar

    bradfeld/ceos

    A skill your agent uses when managing the rolling market calendar - conferences, launches, fundraising milestones, partner events, and team constraints

    154 GitHub stars~2k tokensUpdated 24 days ago
    Business, Finance & HRAuto-check passed
  • Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed
  • Uv

    astral-sh/claude-code-plugins

    Official

    Guide for using uv, the Python package and project manager. An agent skill from astral-sh/claude-code-plugins.

    314 GitHub starsUsed in 2 repos~980 tokens
    Product & Project ManagementAuto-check passed
  • Project Management

    kunchenguid/firstmate

    Agent-only procedure for Firstmate project management. An agent skill from kunchenguid/firstmate.

    7.6k GitHub stars~2.1k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • Hivemind Goals

    activeloopai/hivemind

    Create, track and update team goals via the Deeplake virtual filesystem at memory/goal/.

    1.6k GitHub stars~1.7k tokensUpdated 9 days ago
    Product & Project ManagementAuto-check: notes
  • Ichartjs

    wanghetommy/ichartjs

    Plan, validate, render, explain, and safely edit iChart.js visualizations from tabular, project, or diagram data.

    352 GitHub stars~3.4k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

More from mattolson/agent-sandbox

  • Operating In Agent Sandbox

    mattolson/agent-sandbox

    Read this when you are an AI coding agent running inside an Agent Sandbox container.

    208 GitHub stars~2k tokensUpdated 6 days ago
    Auto-check passed
  • Plan

    mattolson/agent-sandbox

    Entry point for the three-tier planning system. An agent skill from mattolson/agent-sandbox.

    208 GitHub stars~1.1k tokensUpdated 6 days ago
    Auto-check passed
  • Plan Milestone

    mattolson/agent-sandbox

    Break a milestone into discrete tasks. An agent skill from mattolson/agent-sandbox.

    208 GitHub stars~1.1k tokensUpdated 6 days ago
    Auto-check passed
  • Plan Task

    mattolson/agent-sandbox

    Plan and track execution of a task. An agent skill from mattolson/agent-sandbox.

    208 GitHub stars~1.4k tokensUpdated 6 days ago
    Auto-check passed
  • Add Agent

    mattolson/agent-sandbox

    Add a new AI coding agent to Agent Sandbox. An agent skill from mattolson/agent-sandbox.

    208 GitHub stars~3.2k tokensUpdated 6 days ago
    Auto-check passed

Questions about Plan Project

What does Plan Project do?

Create a project plan for a new initiative. An agent skill from mattolson/agent-sandbox. Plan Project is an agent skill from mattolson/agent-sandbox. Create a project plan for a new initiative.

When should I use Plan Project?

Plan Project fits situations like: starting a new project; breaking work into milestones; doing initial technical due diligence.

How do I install Plan Project in Claude Code?

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

How do I install Plan Project in Codex?

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

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

What does Plan Project need to run?

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

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

Plan Project is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Plan Project use?

About 1.1k tokens (SKILL.md is roughly 4.6k 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 Plan Project?

Skills that share tags, products or a category with Plan Project: Ceos Calendar (bradfeld/ceos, 154 stars), CCPM Project Management (automazeio/ccpm, 8.4k stars), Uv (astral-sh/claude-code-plugins, 314 stars) and Project Management (kunchenguid/firstmate, 7.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Plan Project?

mattolson (a GitHub user) maintains it in mattolson/agent-sandbox, which has 208 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 1, 2026.

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