Creating a new wskill

§ 1Purpose

Start a new wskill for a topic from the wcl template, set its topic, and prove the empty model renders.

§ 2Prerequisites

• WCL installed — see the WCL wskill to install it.

§ 3Flowchart

§ 4Steps

$ wcl init wskill docs/wskills/<topic>
$ cd docs/wskills/<topic>

Run wcl init wskill <path> to scaffold the folder — wskill.wcl, the schema/, the wdoc/ templates and an empty data/. Don't hand-create it. Answer the prompts (topic id, name, summary, whether to ship the optional presentation/training views), or pass -D key=value / --defaults.

topic <id> {
  name    = "<Topic name>"
  summary = "<One-line description of the topic.>"
  version = "1.0.0"
  created = "<YYYY-MM-DD>"
}

Edit wskill.wcl and fill in the single topic block — its id, name and summary describe the whole wskill. Pin version to the upstream version when the topic has one, and add source blocks for where authoritative information lives (they drive the update workflow).

$ just wskill-check     # wcl check on the model + every template
$ just render           # out/book + out/skill
$ just book-serve       # live preview

Before adding any content, prove the pipeline: the scaffolded model must check clean and render. If this fails now, fix it now — every later error will then be about your content.

Follow Adding content for the capture loop — decompose, classify with the decision guide, write, link, and pin each unit into an index. Once a handful of units exist, build the index so the book nav and SKILL.md reflect the topic's real shape.