Skills — de leidraad door de keten

Skills zijn niet een handigheidje naast Seifer. Ze zijn de uitvoerende laag van de keten. Elke fase — ideation, scaffold, ontwikkelen, deploy — wordt gedragen door skills die weten wat er moet gebeuren, in welke volgorde, met welke output en welke gates.

De kernstelling

Wat een stage bezit staat in Verantwoordelijkheden. Wat een stage doet staat in zijn skills. Zonder de skills is Seifer een mappenstructuur.

Drie lagen

Laag	Wat	Waar
Orchestrator	De main session, met de kennis uit CLAUDE.md	Project-CLAUDE.md
Discipline-agents	Eén agent per discipline, kent zijn skills	software-preparation-plugin → agents/
Skills	Het uitvoerbare werk	Plugins in de marketplace + lokaal in de repo

De delegatielogica

• Heeft de agent een bestaande skill? → roept /skill-naam aan.
• Heeft de agent er geen? → voert het werk zelf uit met de methoden uit discipline-skills.md.
• Vereist de discipline menselijke betrokkenheid? → de agent flagt dat, op basis van human-skills.md.

Dat laatste is dezelfde regel als de gates: een agent stelt voor, een mens beslist.

Waar skills wonen

Skills zitten op vier plekken, en die plek zegt iets over hun bereik.

Waar	Wat	Bereik
~/Projects/claude-code-plugins/	~180 skills als plugin-marketplace: ideation, analyse, architectuur, ontwikkeling, kwaliteit, documentatie	Machinebreed — buiten de Seifer-repo
foundation/kit-packages/<kit>/.claude/skills/	22 integrate-<kit>-kit-skills, één per kit	Lokaal bij het package
foundation/.claude/skills/	De apply-<module>-module-skills + create-capability-module	Foundation-breed
design-system/.claude/skills/	8 skills: rebrand, theming, componenten, prototypes	Het design system
scaffolder/.claude/skills/ · deployment/.claude/skills/	generate-scaffolder-config · onboard-solution — de twee naden	Per stage

De exploratie-skills wonen bewust buiten de repo

ontdek-kansen, kans-uitwerken, xplore en de tientallen analyse-skills leven in claude-code-plugins. solution-explorer/ is hun data- en outputmap, niet hun huis.

Het bestandspatroon: spec + runtime

Skills in deze repo komen als paar:

foundation/kit-packages/backend-storage/
└── .claude/skills/integrate-backend-storage-kit/
    ├── SKILL.md     de uitvoerbare skill die een agent laadt
    └── SPEC.md      de volledige specificatie erachter

De SKILL.md is wat draait. De SPEC.md legt vast waarom het zo werkt — metadata, categorieën, output-modus, evidence-eisen, faalgedrag.

Bij design-system/ en foundation/ staat de spec soms nog los in een skills/-map naast de .claude/-runtime. Dat is dezelfde splitsing, historisch anders neergezet.

De kit-skill-conventie

De 22 kit-skills volgen één vorm, vastgelegd in foundation/kit-packages/KIT-SKILL-CONVENTION.md:

Eén skill per kit-package. Alle 22, zonder uitzondering — ook de kits waar het wiren een enkele import is en er weinig te vertellen valt.

Waarom die uniformiteit het punt is: een agent die een skill vindt voor storage en geen voor cache, leert dat skills optioneel zijn — en stopt met zoeken.

Elke skill heeft dezelfde opbouw: Inputs · Always · Preserve/may change · modi · Output · Failure · Self-check.

Wat een skill oplevert

Skills zijn niet alleen instructies; ze hebben een contract. Uit de spec-metadata van een willekeurige skill:

Veld	Betekenis
purpose	Wat het doet, in één zin
primary_category	generation · transformation · assessment · planning
output_mode	human_readable · hybrid (rapport + bestandswijzigingen)
evidence_mode	required = elke aanbeveling citeert een pad, elke bevinding een file:line
creativity_level	Hoeveel vrijheid de skill heeft
distribution_mode	local (bij het package) of via de marketplace

Dat evidence_mode is niet decoratief. Bij theme-manager betekent het: geen enkele aanbeveling zonder bronverwijzing.

Verder

• Skill-catalogus per fase — welke skill hoort bij welke stap
• De 40 disciplines — het onderliggende model, met dependency-graaf en artefact-conventies