pm

Manages the .pm adoption board by creating, moving, and closing workstreams, milestones, and tasks.

275|32|Updated Oct 2, 2020
One-click install
npx skills add https://github.com/bex-co/beancount-io --skill pm-bex-co
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pm
Source: https://github.com/bex-co/beancount-io/tree/main/.agents/skills/pm
Command: npx skills add https://github.com/bex-co/beancount-io --skill pm-bex-co

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping a public project-management board consistent is tedious: statuses drift across files, completed work lingers in the open tree, and numbering collides. This Skill enforces the .pm board conventions so every workstream, milestone, task, and inbox note stays synchronized and correctly filed. ## Core Features & Use Cases - Board lifecycle management: Create workstreams, capture inbox notes, promote notes into milestones, add tasks, and mark work done with automatic moves into done/ directories. - Blocked and dropped work handling: Park blocked items under blocked/ with an explicit unblock condition, and drop unwanted work with a public tombstone record. - Status and validation reporting: Run a status pass that lists next actionable tasks per milestone and flags convention violations such as missing pillar linkage or vague definitions of done. - Use Case: A maintainer asks to promote an inbox idea into a milestone; the Skill applies the sizing rule, creates the milestone with standing closing tasks, links it to an adoption pillar, and updates the workstream README. ## Quick Start Ask the agent to run /pm status to show the current board state and the next actionable task in each milestone.

Frequently Asked Questions about pm

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage a markdown-based project board with an AI agent?

Invoke the /pm skill with a subcommand such as status, add, promote, done, block, or drop. It reads the .pm directory tree, applies the board conventions, and performs the file moves and status updates needed to keep the board consistent.

How do I create a milestone from an inbox note?

Run /pm promote <wN/NNN> or /pm new milestone <wN> <title>. The skill first applies a sizing rule: work over roughly one hour with multiple tasks becomes a milestone directory with task files and standing closing tasks, while smaller work stays as an inbox note.

When should work be an inbox note instead of a milestone?

Work estimated at roughly one hour or less, or consisting of only a task or two, belongs in a plain inbox note wN/NNN.md. Milestones are reserved for shippable chunks requiring more than one task and more than about an hour of effort.

What happens to completed tasks and milestones?

Completed tasks move to wN/mN/done/ and completed milestones move to wN/done/mN/, with status lines and workstream checkboxes updated in sync. The skill verifies the old open paths no longer exist before reporting success.

What is the difference between blocking and dropping work?

Blocking parks still-wanted work under blocked/ with a written unblock condition and keeps its number and checkbox. Dropping permanently removes unwanted work, deletes its files, and leaves a tombstone line under a Dropped section with the reason.