The lay of the land.

Before you can bless a taxonomy decision, you need the words. This lesson is just vocabulary — five things, five diagrams. No history, no decisions yet. Just "what are we even talking about."

Foundations · vocabulary · no decisions yet
Concept 01 — Workshop

A workshop is a folder where you build skills.

Not deploy them. Not run them. Build them. The skill lives in the workshop while it's being designed, tested, and iterated. Once it works, you ship it out — to your global Claude home, to a project, or wherever. The workshop is the workbench, not the showroom.

You have one workshop right now: skills-lab/. It sits at ~/lab/projects/_agentic-lab/skills-lab/. Future siblings (already planned) include hooks-lab/, cli-lab/, mcp-lab/ — each its own workshop for a different kind of Claude Code thing.

~/lab/projects/_agentic-lab/skills-lab/ 🔨 scaffold 📋 test 🔍 audit 📦 install your-skill-in-progress/ SKILL.md · CHANGELOG.md · _system/
workshop = workbench. tools on the wall, work-in-progress in the middle.
The vocab swap

When SL-5.3 or any taxonomy chat says "workshop", they mean this folder. Not Claude. Not the chat. Not the editor. The literal directory at skills-lab/ where skills get built.

Concept 02 — Skill

A skill is a folder with a SKILL.md inside.

That's the whole shape. A folder + a SKILL.md = a skill. Claude finds it, reads the description, and lets you invoke it with /skill-name. Add a CHANGELOG.md, some scripts, a _system/ umbrella, and you've got a substantial skill — but the SKILL.md is the only required file.

You already have ~80 of these. Some live globally at ~/.claude/skills/. Some live in workshops while they're being iterated. The same folder shape works in both places.

retro/ 📄 SKILL.md ← the one required file 📄 CHANGELOG.md (optional) 📁 scripts/ (optional) 📁 _system/ (recommended — see Concept 04)
SKILL.md = the contract. Everything else = optional flavor.
Why this matters

Half the taxonomy questions you're going to bless are about WHERE this folder lives — at the workshop root? Inside _meta-skills/? Inside a family workshop like mission-control/? Same folder shape, different home, different meaning. That's the next concept.

Concept 03 — Three homes

A skill folder can live in one of three places.

This is the part SL-5.3 just blessed (verdict D9, lesson 2). The three homes are not interchangeable — where a skill lives signals what it IS.

skills-lab/ (the workshop) _meta-skills/ tools that operate on other skills scaffold-skill · install-skill · audit-skill · test-skill · build-skill never installs globally — workshop machinery only mission-control/ (family workshop) tools that operate on chats / workers / dispatch infrastructure log-relay · retro · dispatch-worker · relay-writer install behavior declared per family in CLAUDE.md <skill-name>/ (flat at workshop root) tools that don't fit either bucket — regular skills handoff-creator · closeout · maintenance · billing these are what installs globally most often
Three homes. Where the folder lives = what the skill is.
The cheat sheet

"Operates on other skills" → _meta-skills/
"Operates on chats/workers" → mission-control/
"Operates on the rest of your world" → flat <skill>/

Concept 04 — The _system/ umbrella

Every project gets a 5-folder filing cabinet.

Skills, workshops, family folders, your master projects — anything that's a "project" gets a _system/ folder with the same 5 sub-folders inside. Always the same 5. Memorize them once.

_system/ 📁 handoffs/ work passed in or out of this project 📁 ideas/ things to maybe build later 📁 research/ decision docs · prior art · brainstorms 📁 resources/ templates · schemas · shared assets 📁 runs/ test outputs · execution logs · per-run artifacts
Five sub-folders. Always the same five. Predictable.
Why the underscore prefix

The _ sorts it to the top of ls output and signals "meta / housekeeping, not the main attraction." Same trick used by _meta-skills/, _personal/, _business/, etc.

Concept 05 — Family workshop + 3-level nesting

A family workshop is a folder holding sibling skills.

This is the new piece SL-5.3 blessed (verdict D8). When you've got 2+ skills that share a domain — say, several skills that all touch dispatch-relay infrastructure — you can group them under a family folder. mission-control/ is the first instance.

The clever bit: each level (workshop, family, per-skill) keeps its OWN _system/. Three umbrellas, three scopes.

skills-lab/ (workshop) 📁 _system/ (workshop-wide) mission-control/ (family) 📁 _system/ (family-wide) log-relay/ (one skill) 📄 SKILL.md · CHANGELOG.md 📁 _system/ (per-skill) retro/ (another skill) 📄 SKILL.md · CHANGELOG.md 📁 _system/ (per-skill)
3 levels of _system/ : workshop-wide, family-wide, per-skill.
The "what lands where" rule

Workshop _system/ = stuff that touches multiple families (new skill ideas, cross-skill research).
Family _system/ = stuff that touches multiple skills in this family (shared schemas, family-wide handoffs).
Per-skill _system/ = stuff specific to this one skill (its iteration history, its test runs).

Recap

You now know the vocabulary.