4. Ship the AI skill

Curate what an agent sees, render the skill, and install it.

After this lesson you can

- Opt units into the skill with audience - Configure the skill block (description, parameters, boundaries) - Build and install the skill where an agent loads it

Before you start: Processes and the curated index

The skill is curated up: every unit defaults to :book, so mark what the agent needs :both (shared reference) or :ai (agent-only notes). The skill block in wskill.wcl becomes SKILL.md's frontmatter — its description is the trigger text — and skill_boundary rules render as hard rules the agent must follow.

An :ai/:both index becomes a section of SKILL.md's Reference — curating those indexes IS designing the agent's entry points.

§ 1Exercise: Render and install

Tag your best units :both, add an :ai index over your runbooks, then build the skill and install it into a repo.

bash
just skill-build
cp -r out/skill <repo>/.claude/skills/my-topic

Expected result

.claude/skills/my-topic/SKILL.md lists your index as a Reference section, and an agent session in that repo can answer from the skill's pages.

Hint

If the agent never invokes the skill, sharpen the description in the skill block — it is what the agent matches requests against.