Render a document into a Claude skill folder
§ 1Purpose
Project an :ai_skill site into a SKILL.md plus references/, scripts/, and assets/.
§ 2Prerequisites
- A site with default_template = :ai_skill and a skill { } block
- A page marked start = true
§ 3Flowchart
§ 4Steps
§ 4.11
§ 4.2Run the skill target
$ wcl wdoc skill site.wcl --out out/skill
Render the document to a skill folder under out/skill. The output directory is created if missing; with several skill sites, each renders into its own out/skill/<name>/ subfolder.
§ 4.32
§ 4.4Inspect the folder layout
$ ls -R out/skill
SKILL.md references scripts assets
out/skill/references:
usage.md
The start page becomes SKILL.md at the root with its front matter from the skill { } block; every other page is written under references/<name>.md; and each file block ships into the subfolder named by its dir (scripts/, assets/).
§ 4.53
§ 4.6Check it builds as a skill, not HTML
Use the skill target
Running wcl wdoc build on an :ai_skill site fails with a message pointing you at wcl wdoc skill — :ai_skill is a Markdown-only target.
If wcl wdoc build errors on this site, that is expected: skill sites only render through wcl wdoc skill.
Verification
out/skill/SKILL.md exists with name/description front matter, and the non-start pages appear under out/skill/references/.