Patterns

---
name: "Actuate a Large Reference With a Thin Firing Skill, Not by Making the Doc a Skill"
polarity: pattern
use_this_when: "Making a large valuable reference (a long doctrine doc, a grammar, a deep guide) actually fire for agents at the moment of work."
category: process
proven_in: "grammar-of-thinking → oak-reason; the working-with-agentic-ai primer; the orientation lens (2026-06-22 Orbit)"
proven_date: 2026-06-22
barrier:
  broadly_applicable: true
  proven_by_implementation: true
  prevents_recurring_mistake: "Shipping a big reference AS a slash-command skill — passive guidance that artefact-gravity predicts will not fire at the action moment."
  stable: true
---

> **POLARITY: PATTERN.** A shape to repeat: actuate a large reference with a
> thin, task-triggered firing skill that points to the doc — never by shipping
> the doc itself as the skill.

## The failure shape

Shipping a big reference (a ~1,400-line grammar of thinking, a deep guide) AS a
skill is passive guidance with a slash command. `passive-guidance-loses-to-artefact-gravity`
predicts it will not fire under context pressure: nobody reads a 1,400-line skill
body at the action moment.

## The shape

- **Thin firing surface, depth behind it.** The skill carries a small *killer
  subset* of firing **questions** plus an **impact test** (the pass must change a
  framing or a decision, not just restate the plan), and points to the full
  document as the deep reference.
- **Canonical-body / thin-adapter seam.** Same seam as the orientation primer and
  `oak-reason`: the canonical body is large and lives once; the firing adapter is
  small and task-triggered. The reference is read *to learn*; the skill fires *to
  act*.
- The impact test is what keeps the thin skill honest — a pass that produced no
  reframing, surfaced warrant, or altered decision is a failed pass, not a
  completed checklist.

## Related

- [`passive-guidance-loses-to-artefact-gravity.md`](passive-guidance-loses-to-artefact-gravity.md)
  — the problem this pattern cures (passive guidance needs an active firing gate).