Skills Documentation System

Single source of truth for both human-readable web docs and LLM agent consumption.

Architecture

skills/skills/{skill-name}/
  SKILL.md                    # Overview + quick start (LLM entry point)
  references/
    {name}.md                 # Reference, tutorial, how-to, or explanation

Two build targets from one source:

• Web docs: Telecine reads skills/skills/ directly, renders with MDX + convention-based component mapping
• LLM skills: generate-skills.ts strips human-only metadata, converts API metadata to prose, outputs to skills/skills-generated/ (gitignored build artifact)

Authoring Workflow