Playbook Builder
Create structured, reliable skills for Claude Code agents. A playbook is a skill that follows a transactional pattern: read fresh state, process, write state, verify.
Installation
/plugin marketplace add abilityai/abilities /plugin install playbook-builder@abilityai
What is a Playbook?
A playbook is a skill that follows a specific pattern for reliability and portability:
READ FRESH STATE → PROCESS → WRITE STATE → VERIFY
•Self-contained — Don't rely on stale conversation context
•Portable — Work the same locally and on Trinity
•Traceable — All state changes are explicit
•Recoverable — Clear what to check if something fails
Skills
| Skill | Purpose |
|---|---|
| /create-playbook [name] | Create a new skill (any tier) |
| /save-playbook [name] | Capture current conversation as a playbook |
| /adjust-playbook [name] | Modify an existing skill |
| /playbook-architect | Audit agent and propose improvements |
Skill Complexity Tiers
| Tier | Type | When to Use | Required Elements |
|---|---|---|---|
| 1 | Simple Skill | Stateless, one-shot tasks | Purpose, Process |
| 2 | Stateful Skill | Reads/writes files or APIs | + State Dependencies table |
| 3 | Full Playbook | Scheduled, autonomous, needs reliability | + Read/Write steps, Checklist, Recovery |
Automation Levels (Tier 3)
| Level | When It Runs | Human Role | Use For |
|---|---|---|---|
| Autonomous | On schedule | None | Metrics, backups, monitoring |
| Gated | Schedule/trigger | Approve at checkpoints | Content, deployments |
| Manual | When invoked | Full control | Dangerous ops, migrations |
Quick Start
Capture What You Just Did
/save-playbook deploy-workflow
After completing a task, capture it as a reusable playbook. Analyzes the conversation to extract steps, state dependencies, and automation level.
Create a New Skill
/create-playbook weekly-report
Guides you through creating a skill from scratch. Asks questions to determine the right tier.
Audit Your Agent
/playbook-architect
Reviews all your skills and proposes improvements without losing any existing functionality.
Skill Versioning
When making breaking changes, archive the current version first:
skills/ my-skill/ # Current version (always latest) my-skill-v1/ # Archived version (frozen) my-skill-v2/ # Archived version (frozen)
Use /adjust-playbook with --archive to automatically version before major changes.