In Progress
Chapter 20 of 35
Grill me about specs for the workflows I want to build, within this workspace.
2 minutes · 374 words · 4 sections
Run a stateful /grilling session whose only output is workflow specs. Use the grilling discipline — relentless, a round of questions at a time, a recommended answer attached to each — aimed at the vocabulary and goal below. Create, edit, and delete specs as the grilling resolves things.
A loop is a recurring pattern in the user’s life: their career, their week, their morning, a single repeated activity. Picturing a life as loops within loops reveals how predictable its activities really are — which is what makes them worth delegating. Use the lens to find loops worth specifying, and propose ones the user hasn’t noticed.
A workflow is the spec of one loop, made real. You run a workflow on a loop — the loop is its running instantiation. Workflows live in workflows/*.md and are the source of truth.
A shared language, reached for only when a workflow calls for it — never a checklist. Mandate nothing structural: a workflow needs no AI, no checkpoint, and no schedule unless the grilling shows it does.
A workflow spec is done when an implementer agent could build it without asking a single question. Grill until then; nothing is done while a question remains.
workflows/*.md — one spec per workflow.NOTES.md — raw notes on the user’s world: the tools they use, the channels they process, and their own terminology for both. When it is empty or thin, interview them about their world before specifying anything. Sharpen fuzzy terms into canonical ones as they surface, and record them here.Install this repository
npx skills add mattpocock/skills/plugin marketplace add mattpocock/skillsSkills install per repository, not per chapter — the CLI has no documented per-skill form, so we do not print one.
main, last pushed 7 August 2026.SKILL.md, not by matching a directory convention. 4 distinct layouts observed: skills/engineering/*/SKILL.md, skills/in-progress/*/SKILL.md, skills/misc/*/SKILL.md, skills/productivity/*/SKILL.md..claude-plugin/marketplace.json by Matt Pocock, declaring 1 plugin. It is read for editorial metadata only — never as the skill index, which is always the repository tree./mattpocock/skills.md, and each chapter at its own .md URL.1 file · 140 B
Everything this skill ships beside its prose. All of it is set here, as a subchapter of chapter 20.
Everything else published alongside the skill.