Table of contents
Skill
Formal definition
A Skill is a triple :
where:
- is the closure-kind — which position in the nuclear quartet the skill occupies
- is the input type and the output type — types of elements in fibers of
- is the judgment — a map from input to output within the fiber at history
The closure-kind constrains the nuclear position of ’s output:
| Fiber position | Nuclear condition on | |
|---|---|---|
| Process () | and — fully settled | |
| Procedure () | but — conditionally branches | |
| Derivation () | but — inferred, not yet saturated | |
| Inquiry () | raw | no fixed-point condition — structure discovered at runtime |
Morphism reading. A Skill is a morphism in the category whose objects are fiber types and whose morphisms are judgment maps. Runbooks are composable paths in : output type of step must equal input type of step .
One step of judgment. A Skill executes exactly one closure-kind position. It does not sequence, loop, or call other skills. All structure — chaining, branching across skills, looping — belongs in a Runbook.
What this is
A Skill is a named, invokable unit of compiled procedural knowledge — automatic, repeatable, and reliable once acquired. In ACT-R and cognitive science, a skill is procedural memory that runs without deliberation: the agent does not reason about how to do it, it just does it. In robotics, a skill is the middle layer: parameterized, reusable, composed into task plans by a higher-level planner. In AI agent frameworks, a skill is a named capability with defined preconditions and effects that an agent can invoke reliably. The invariant across all three: a skill is a discrete, named, deployable unit of method — not a plan, not a goal, not a task, but the compiled knowledge of how to do one specific thing.
In this system, a Skill packages what an agent should reason about — the question to answer, the rules to apply, the conditions to branch on, or the territory to explore — in a single, invokable unit. A Skill is one step of judgment. Everything else — sequencing, I/O, looping, orchestration — belongs in a Runbook.
Every Skill occupies exactly one position in the nuclear quartet, declared by closure-kind. The four positions are Process, Procedure, Derivation, Inquiry.
Relationship to Runbooks
A Runbook sequences skills. A Skill does not sequence itself — it does not know what comes before or after. The same Skill can appear in multiple Runbooks without duplication. This decouples judgment (Skill) from structure (Runbook).
Location
Skills live as close to their content as possible:
| Path | Who uses it |
|---|---|
skills/ |
any agent in the repo |
spec/skills/ |
agents working on spec content |
math/skills/ |
agents working on math content |
src/skills/ |
agents working on engine code |
A Skill MAY be a single .md file or a directory with a main file plus supporting files.
Name a skill by what it produces — full rules in name.