Agent Booster Pack — Skills

ABP skills packaged for Pi, the terminal coding agent. Helps Pi produce code that is well-organized, low in complexity and side effects, and is secure and performant.

This package is skills only and carries the general ABP skills. Runtime-owned skills ship with their matching sibling packages:

• agent-booster-pack-contract-first — Interface Design Gate runtime plus the contract-first skill.
• agent-booster-pack-proof — proof-first red-green-refactor runtime plus the proof skill.
• agent-booster-pack-whiteboard — one-question whiteboarding runtime plus the whiteboarding skill.

The pack covers data modeling, code review, security, debugging, refactoring, and more. The canonical skill source lives at agents/.agents/skills/ in the parent repository; skills/ here is built from that source at npm-pack time and is not committed.

Renamed from pi-agent-booster-pack. The old name is deprecated; migrate to agent-booster-pack-skills for ongoing updates. The meta-package agent-booster-pack installs all four agent-booster-pack-* packages at once.

Install

From npm (recommended)

pi install npm:agent-booster-pack-skills

Then in Pi:

/reload

For the full ABP experience (general skills + runtime-owned skills + gates), install the meta-package instead:

pi install npm:agent-booster-pack

From a local checkout

For development against the live source. Run the build first so the skills exist in agent-booster-pack-skills/skills/:

cd /path/to/agent-booster-pack/agent-booster-pack-skills
npm run build
pi install /path/to/agent-booster-pack/agent-booster-pack-skills

Then in Pi:

/reload

Local development symlink

If you are iterating on skills and want a single command for build + install:

cd /path/to/agent-booster-pack/agent-booster-pack-skills
npm run install-ext

This builds skills/ and symlinks the working tree into ~/.pi/agent/extensions/agent-booster-pack-skills. Re-run npm run build and /reload in Pi after editing skills.

Note: pi install git: does not currently support installing a subdirectory of a repository, so pointing at the parent agent-booster-pack git URL will not work. Use the npm install (above) or a local checkout.

What's included

The general ABP skills, grouped by the kind of engineering pressure they apply.

Entry point

• workflow — choose the right ABP skills for the task, name what is being coupled, keep the work scoped, and connect completion claims to proof.

Foundational design

• domain-modeling — domain data, fields, states, transitions, effects.
• architecture — module boundaries, domain locality, DDD tactical patterns.

Correctness and change

• code-review — risk-focused review of diffs, branches, PRs.
• debugging — root-cause investigation.
• refactoring — behavior-preserving structure changes.
• error-handling — error types, propagation, retries, recovery.

Safety gates

• security — auth, secrets, crypto, input validation, trust boundaries.
• database — schemas, migrations, queries, transactions, deletion semantics.
• release — version bumps, CHANGELOG, rollouts, rollbacks, feature flags.

Production quality

• observability — logs, metrics, traces, dashboards, SLOs, alerts.
• async-systems — async work, queues, streams, ordering, backpressure.
• performance — latency, throughput, caching, allocation, stampede prevention.

Public/user surfaces

• api — HTTP APIs, OpenAPI, idempotency, pagination, webhooks.
• documentation — READMEs, ADRs, runbooks, reference docs.
• ui-design — pages, components, interaction flows, responsive layout.
• accessibility — WCAG, semantic HTML, ARIA, keyboard navigation.

Project workflow

• git-workflow — branch hygiene, commit splits, rebases, history recovery.
• scaffolding — new projects, baseline tooling, CI defaults.

How it works

Pi reads pi.skills from this package's package.json and walks each subdirectory under skills/. Each subdirectory is one skill, with a SKILL.md that has YAML frontmatter (name, description) and a body Pi loads when the skill description matches a task. No code runs from this package.

The runtime gates that enforce ABP workflow phases live in the sibling packages above. Install them separately if you want runtime enforcement.

Build pipeline

skills/ is a build artifact, not a checked-in mirror.

• scripts/build-skills.mjs walks ../agents/.agents/skills/ and copies each skill subdirectory into ./skills/.
• npm run build runs that script directly.
• npm pack and npm publish run it via the prepack lifecycle hook, so the published tarball always reflects the canonical source at the moment of publish.

This means there is exactly one place to author skills (agents/.agents/skills/ in the parent repo), and no chance of agent-booster-pack-skills/skills/ drifting from canon.

Publishing

From inside agent-booster-pack-skills/:

npm publish

prepack runs npm run build automatically, so the tarball includes the freshly-built skills/ directory.

License

MIT — see LICENSE.