Grill with Docs

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go. Use when the grilling session should also leave ADRs and glossary entries behind. Triggers on: grill with docs, grill and document, grill this and write the ADR.

This skill is imported from mattpocock/skills (MIT) and is user-invoked upstream.

When to use this skill

• A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
• Use when the grilling session should also leave ADRs and glossary entries behind.
• Triggers on: grill with docs, grill and document, grill this and write the ADR.

Instructions

Call the Skill tool twice, for "grilling" and "domain-modeling".

Examples

• Apply this skill to one narrow scope first, confirm the output matches the shape described above, then widen to the full task.
• When a step needs a fact from the repository or the environment, look it up instead of asking the user for it.

Best practices

• Keep the upstream procedure intact; record deviations explicitly instead of silently improvising.
• Stop and hand control back to the user at every decision point this skill marks as theirs.
• Prefer small reversible changes, and state assumptions rather than burying them.

References

• Upstream skill: mattpocock/skills skills/engineering/grill-with-docs/SKILL.md (commit 3cca18b, MIT)
• Project standards: .agent-skills/skill-standardization/SKILL.md
• Validator script: .agent-skills/skill-standardization/scripts/validate_skill.sh