interview

Installation
SKILL.md

Interview the user relentlessly until every load-bearing decision is settled, then emit a decision record and stop. Two things break shared understanding: decisions still open, and the same words meaning different pictures. Rounds settle the first; playing your picture back every round exposes the second.

Map the subject as a design tree: every decision branches into the decisions that hang off it. The frontier is every decision whose prerequisites are already settled. A round asks the whole frontier at once. When unsure whether two questions are independent, they are not: put the second in a later round.

1. Recon

Read spec/vision.md and spec/glossary.md if they exist, then the code, docs, and whatever the user pointed at, enough to ground every question in what exists. Report it in three or four lines, then go straight to round zero.

2. Round zero

First ask the user to describe the subject in their own words, as messily as they like, and structure nothing until they have. Then three fixed questions, asked once, never revisited:

Installs
17
Repository
dan86de/skills
First Seen
Jun 3, 2026