doc-to-skilllisted

# doc-to-skill Turn one long-form document into a `SKILL.md` scaffold. **Scaffold only** — the chapter index + claim placeholders give the agent a structured hook to fill in real claims afterwards from the source. The skill does not invent claims itself. ## When to invoke - "Make a skill from this PDF / EPUB / DOCX." - "Scaffold a skill from this paper / book / spec." - "I have a long doc — convert it into a project skill." If the user has a continuously-growing corpus of non-code documents (meeting transcripts, research PDFs accumulating in one folder), point them at `llm-wiki` instead — that is the wiki-shaped sibling. This skill is the **one-shot deep-dive** axis. ## Input contract A single document file readable by pandoc: - PDF, EPUB, DOCX, RTF, ODT, Markdown. - Path on disk (the skill does not download URLs). - Pandoc must be on `PATH` — system install, not a repo dep. ## Process ### 1. Pick the slug + target ```bash "$AI_KIT_ROOT/bin/doc-to-skill.sh" <source-file> [--name <slug>] [--target <dir>] ``` - `<slug>` defaults to the source basename slugified (`my-book.pdf` → `my-book`). - `<dir>` defaults to `./skills` (or `workflow/skills` when run inside ai-kit-the-repo). The script refuses to overwrite an existing `SKILL.md` at the target path — re-runs require a different `--name` or removing the old scaffold first. ### 2. Inspect the scaffold The script writes `<target>/<slug>/SKILL.md` with: - **Frontmatter** — `name` filled, `description` marked `TO