What is it?

A wskill is a self-contained, shareable unit of knowledge on one topic — one data model projected into up to four views.

A wskill is one folder that captures everything about a specific topic — the ideas, the concrete things, the values, the tasks — as a single structured data model. It is self-contained: someone can pick the folder up and learn the topic from it, or follow its processes to get work done, without anything outside it.

The same data projects into up to four views: a reference book for humans, an AI skill an agent like Claude Code loads to do the topic's work for you, and optionally an overview presentation deck and a hands-on training book. Capture once, render everywhere — nothing is hand-duplicated between views.

§ 1Examples

§ 1.1Starting a new wskill

Create a fresh wskill folder with the built-in template, then check and render.

$ wcl init wskill docs/wskills/git      # prompts: topic id, name, summary, optional views
$ cd docs/wskills/git
$ wcl check wskill.wcl                  # must pass
$ just render                           # out/book + out/skill (+ any optional views)

Expected: A docs/wskills/git/ folder with schema, templates, and data skeleton; wcl check passes; out/ holds every shipped view.