Agent skill

Plan Milestone

by mattolson in mattolson/agent-sandbox

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

MITAuto-check passedProduct & Project Management

Install Plan Milestone

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

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

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

At a glance

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

  • Works in 6 steps: Context Review → Learnings Review → Task Identification → …
  • Starting work on a milestone that has been defined in the project plan
  • SKILL.md covers Inputs, Output, Process and Milestone Plan Template
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Plan Milestone is an agent skill from mattolson/agent-sandbox. Break a milestone into discrete tasks. Use when starting work on a milestone that has been defined in the project plan.

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. 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 work on a milestone that has been defined in the project plan
  • Tasks that involve Project management

Example prompts

  • “/plan-milestone”

Workflow steps

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

  1. Context Review
  2. Learnings Review
  3. Task Identification
  4. Dependency Mapping
  5. Risk Identification
  6. Sequencing

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 Milestone loads about 1.1k tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 388 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~34
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). 388 words, ~1,066 tokens.

Download SKILL.mdSave it as .claude/skills/plan-milestone/SKILL.md (or your agent's skills folder).
name
plan-milestone
description
Break a milestone into discrete tasks. Use when starting work on a milestone that has been defined in the project plan.

Milestone Planning

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

This skill breaks a milestone into discrete, implementable tasks. The output is a milestone plan that sequences work and identifies dependencies.

Inputs

Before starting, read:

  • docs/plan/project.md - to understand the milestone's context and goals
  • docs/plan/learnings.md - to incorporate lessons from previous work
  • Any relevant decision documents in docs/plan/decisions/

Output

The final artifact is docs/plan/milestones/{milestone}/milestone.md.

The milestone plan can be updated as work progresses. When task scope changes significantly, update the task definition but also record the change in a Changes section. This preserves history for milestone retrospectives while keeping the plan current.

Process

Work through these phases interactively. Each phase should be a conversation.

Phase 1: Context Review

Review the milestone's definition from the project plan.

  • What is this milestone's goal?
  • What are its boundaries (what's in scope, what's not)?
  • What dependencies does it have on prior milestones?
  • What does completion look like?

Confirm understanding before proceeding.

Phase 2: Learnings Review

Review accumulated learnings that may apply to this milestone.

  • What lessons from previous work are relevant here?
  • Are there process improvements to apply?
  • Are there technical pitfalls to avoid?

Note applicable learnings in the milestone plan.

Show full SKILL.md (190 more words)Show less
Phase 3: Task Identification

Identify the discrete pieces of work.

  • What are the logical units of work?
  • Is each task appropriately scoped for a single PR?
  • Are tasks independently testable or verifiable?
  • What are the natural boundaries between tasks?

A task should map to a well-crafted PR: a piece of functionality or a fix, along with relevant tests, sized appropriately for human peer review. Not so large that review becomes burdensome, not so small that it lacks meaningful context.

Phase 4: Dependency Mapping

Understand how tasks relate to each other.

  • Which tasks block other tasks?
  • Which tasks can be done in parallel?
  • Are there external dependencies (APIs, other teams, etc.)?
  • What is the critical path?
Phase 5: Risk Identification

Flag uncertainties specific to this milestone.

  • Which tasks have technical unknowns?
  • Where might scope be unclear?
  • What could cause rework?
  • Are there tasks that should be spiked first?
Phase 6: Sequencing

Order the tasks for execution.

  • What is the recommended order?
  • Where are there decision points that might change the sequence?
  • Which tasks should be done early to reduce risk?

Milestone Plan Template

When all phases are complete, compile into docs/plan/milestones/{milestone}/milestone.md:

markdown
# Milestone: {identifier} - {name}

## Goal

{What this milestone achieves}

## Scope

{What's included and explicitly excluded}

## Applicable Learnings

{Lessons from previous work that apply here}

## Tasks

### {m1.1-task-name}

**Summary:** {One-sentence description of what this task delivers}

**Scope:**
- {What's included}
- {What's explicitly excluded or deferred}

**Acceptance Criteria:**
- {Condition that must be true when complete}
- {Another condition}

**Dependencies:** {What must be done first}

**Risks:** {Uncertainties or concerns}

### {m1.2-task-name}

**Summary:** {One-sentence description of what this task delivers}

**Scope:**
- {What's included}
- {What's explicitly excluded or deferred}

**Acceptance Criteria:**
- {Condition that must be true when complete}
- {Another condition}

**Dependencies:** {What must be done first}

**Risks:** {Uncertainties or concerns}

{Continue for all tasks}

## Execution Order

{Recommended sequence, noting parallelization opportunities and decision points}

## Risks

{Milestone-level risks and mitigation strategies}

## Definition of Done

{How we know this milestone is complete}

## Changes

{Record significant changes to scope or tasks as they occur}

### {Date}: {Change summary}

{What changed and why}

© 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-milestone of mattolson/agent-sandbox.

Open the folder on GitHubat commit c5b65e7

Compare with similar skills

Plan Milestone 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 Milestone compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Plan Milestone this skillmattolson/agent-sandbox208—~1.1kAutomated safety check: PassMIT
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Uvastral-sh/claude-code-plugins3132 repos~980Automated safety check: PassApache-2.0
Project Managementkunchenguid/firstmate7.7k—~2.1kAutomated safety check: PassMIT
Hivemind Goalsactiveloopai/hivemind1.6k—~1.7kAutomated safety check: NotesApache-2.0
Ichartjswanghetommy/ichartjs352—~4.2kAutomated safety check: PassApache-2.0

Similar skills

  • 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.

    313 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.7k 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 10 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~4.2k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • Hivemind Goals

    activeloopai/hivemind

    Create, track and update team goals in Hivemind via the hivemind CLI.

    1.6k GitHub stars~814 tokensUpdated 10 days ago
    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 7 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 7 days ago
    Auto-check passed
  • Plan Project

    mattolson/agent-sandbox

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

    208 GitHub stars~1.1k tokensUpdated 7 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 7 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 7 days ago
    Auto-check passed

Questions about Plan Milestone

What does Plan Milestone do?

Break a milestone into discrete tasks. An agent skill from mattolson/agent-sandbox. Plan Milestone is an agent skill from mattolson/agent-sandbox. Break a milestone into discrete tasks.

When should I use Plan Milestone?

Plan Milestone fits situations like: starting work on a milestone that has been defined in the project plan; tasks that involve Project management.

How do I install Plan Milestone in Claude Code?

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

How do I install Plan Milestone in Codex?

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

Can I use Plan Milestone 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-milestone -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-milestone, .gemini/skills/plan-milestone, .github/skills/plan-milestone and .opencode/skills/plan-milestone in your project.

What does Plan Milestone need to run?

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

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

Plan Milestone 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 Milestone use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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 Milestone?

Skills that share tags, products or a category with Plan Milestone: CCPM Project Management (automazeio/ccpm, 8.4k stars), Uv (astral-sh/claude-code-plugins, 313 stars), Project Management (kunchenguid/firstmate, 7.7k stars) and Hivemind Goals (activeloopai/hivemind, 1.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Plan Milestone?

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.