Skill Reference Standard
The playbook is the reference layer for building skills.
A skill should carry doctrine the playbook has already made clear: the capability, human edge, AI delegation boundary, proof signal, and receipt. The public page does not need to point into agent internals. The operational skill points back to the public reference.
Core Rule
Skills may reference playbook pages. Playbook pages should not depend on private skill paths.
That direction matters. The playbook stays readable and public. Skills stay operational and testable.
Skill Reference Contract
Before a skill is written or materially improved, name:
| Field | Question |
|---|---|
| Playbook reference | Which public page is the source doctrine? |
| Capability or doctrine | What capability, standard, or loop is being operationalized? |
| Human edge | What judgment, trust, taste, responsibility, or relationship remains human? |
| AI delegation boundary | Is the agent doing, assisting, orchestrating, automating, or governing? |
| Skill output | What artifact, decision, action, or review does the skill produce? |
| Proof signal | What observable evidence shows the skill worked? |
| Receipt | What should the next loop inherit? |
Use the delegation ladder:
Do -> Assist -> Orchestrate -> Automate -> Govern
How To Use
When building a skill:
- Start from the closest playbook page.
- Extract the capability, human edge, and proof signal.
- Convert the doctrine into a skill output contract.
- Add evals or gates that can fail when the skill misses the proof signal.
- Emit or name the receipt the next loop should reuse.
If no public reference exists, improve the playbook before treating the skill as canonical.
Failure Modes
- The skill invents doctrine that no playbook page explains.
- The playbook links into private skill paths and becomes an operator manual.
- The skill has a trigger but no proof signal.
- The skill outputs text but no receipt, gate, or reusable artifact.
- The agent automates work without naming the human edge it must preserve.
Context
- Agency - why capabilities compound.
- Capabilities - the human and AI capability scorecard.
- Credibility - commitments kept over time.
- Work Mapping - where AI can act and where humans must govern.
Questions
Which playbook page would a future agent read to understand why this skill exists?
- What proof signal would show the skill improved the loop?
- What human edge would be damaged if the skill automated too much?
- What receipt lets the next skill or flow start from proof instead of memory?