book-to-skill

# Book to skill ## Contract | Field | Bound contract | |---|---| | Trigger | The user names one book, course, paper, or comparable single source document and asks to distill it into a reusable skill. | | Authority | Reversible local: writes only the chosen target skill directory (SKILL.md and optional references/); rollback is deleting that directory. No remote mutation. No source file is mutated or copied wholesale. | | Side effect | Creates files under the chosen target directory only; never copies the source document into the skill. | | Done | A SKILL.md that parses as YAML, carries an attribution line, passes four validation checks, and routes correctly on at least two positive and two negative probe prompts. | ## Inputs - The named source document, accessible as a file the agent can open. A document the agent cannot open stops the run. - Optional: a write target directory, defaulting to `.claude/skills/<name>/`. - A folder of multiple sources is out of scope; that belongs to corpus mapping, not this skill. ## Procedure 1. **Read the source.** List its chapters, top-level headings, or sections, whichever structure the document provides. Show one line per unit with its heading slug where one exists. Done when: an inventory covering every top-level unit is shown. 2. **Classify.** Ask whether three or more ordered actions can be named, each with a checkable done-state. Three or more is **procedure** (a sequence the agent can follow). Fewer is **reference** (distinction...