# Skills

A personal collection of agent skills packaged through Nix.
The language below covers the knowledge-mining pipeline — the `consume` (write) and `wiki` (read) pair that move knowledge into and out of the user's Obsidian vault.

## Language

### Places

**Vault**:
The user's personal Obsidian knowledge base, read through `wiki` and written only within one area by `consume`.
_Avoid_: notes folder, Obsidian

**Pull channel**:
The vault area holding reusable knowledge, retrieved on demand by a future agent that goes looking for it.
_Avoid_: wiki proper, retrieval store

**Push channel**:
The target's own always-loaded documentation (`AGENTS.md`), whose value is being in front of an agent unprompted.
_Avoid_: proactive store, always-on docs, `CLAUDE.md`

**Target**:
The single source `consume` ingests in one run — currently a project directory.
_Avoid_: source (reserve for the raw material within the target), input

**Compatibility surface**:
A legacy harness-specific file or directory that points an older agent harness to the canonical agent-neutral surface.
_Avoid_: duplicate source, mirror

### Acceptance axes

**Generalizes**:
A mined fact's property of teaching something true on a *different* target, not only the one it came from.
_Avoid_: reusable, transferable (use only informally)

**Trigger-able**:
A mined fact's property of having a recognizable symptom, error, or task that would send a future agent to retrieve it.
_Avoid_: searchable, useful

### What a source line yields

**General lesson**:
The transferable principle split out of a source line.
_Avoid_: concept, insight

**Specific residue**:
The concrete, target-only answer left after the general lesson is split off.
_Avoid_: leftover, detail

**Proactive rule**:
A mined fact that generalizes but is not trigger-able — a verification-discipline or design-stance rule whose value is firing unprompted.
_Avoid_: habit, guideline

### Planning

**Contribution map**:
The many-to-many record of which consumed file fed which planned note, with the exact contributing sections, including files that fed nothing.
_Avoid_: provenance table, coverage map