wskill

A self-contained knowledge format: capture a topic once, project it into a book, an AI skill, a deck, and a training course.

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.

Why use this?

Preserve a topic's knowledge in a reusable format that serves both people and AI agents — and still works manually if you lose access to the agent.

Separation of Data and Presentation

Keep data and presentation separate: declare the topic once as data in a natural shape, and let the templates own how it looks — so one model can feed several outputs with nothing hand-duplicated.

Four kinds of unit

Break a topic into atomic notes — one idea each — then file each as the unit kind that fits it: concept, entity, fact or process.

- Concept — an idea to understand

- Entity — a concrete named thing (person, software, place)

- Fact — values and value tables

- Process — a runbook of steps

Which unit kind? — the decision guide

Entities are reserved for concrete named things.

An idea is a concept. A table is a fact. A task is a process.

Atomic Note

Each unit captures exactly one idea — one concept, entity, fact or process.

One idea per unit; related links weave the web.

Curated index trees shape the nav — in the book AND in SKILL.md.

The view family

One data model, four projections: the book and the AI skill are standard; the presentation deck and the training book are optional.

Book — the reference · Skill — for agents

Deck — first contact · Training — learning path

Anatomy of the AI skill

What wcl wdoc skill emits: SKILL.md (frontmatter, boundaries, parameters, index-driven Reference) plus references/, scripts/, assets/.

Curated up: units opt in with audience = :ai / :both.

Boundaries render as hard rules; indexes become the agent's entry points.

Custom projections (schema extension modules)

Model domain data — a language's builtins, a CLI surface — as typed blocks in a schema module, then project them into generated reference pages.

A language's builtins, a CLI surface, keybindings — typed blocks, projected pages.

Three commands

wcl init wskill ./my-topic

wcl check wskill.wcl

just render