Building and installing the AI skill

§ 1Purpose

Render the skill projection and install it where an agent loads it.

§ 2Prerequisites

• The skill block is configured — see Setting up AI skill generation.

§ 3Flowchart

§ 4Steps

$ just skill-build          # → out/skill/  (SKILL.md + references/)

wcl wdoc skill writes SKILL.md, one references/*.md per :ai/:both unit, and any bundled scripts//assets/ files. The build fails loudly on broken links or schema errors — fix and re-run.

$ cp -r out/skill <repo>/.claude/skills/<name>

Copy the rendered folder into the target repo's .claude/skills/<name>/. Use the name from the generated SKILL.md frontmatter — that is what the agent invokes. If the render has an agents/ folder (the skill ships subagents), also copy agents/*.md into the repo's .claude/agents/ — subagent files load at session start, so restart after installing. A repo that hosts the wskill source usually wraps this in its own just recipe so the installed copy regenerates with the model.

Open an agent session in the target repo and ask something squarely inside the skill's description. The agent should invoke the skill and answer citing its reference pages. If it never triggers, sharpen the description in the skill block — it is the trigger text.