mcpField
G
grill-with-docs

grill-with-docs

github.com/akillnessDevelopment53366 installsUpdated today
Repository

About grill-with-docs

A skill for interviewing users to refine a plan or design while producing ADRs and glossary entries. It suits teams that want decision records and domain terms documented during the discussion.

Key features

  1. 01Structured interview to refine plans
  2. 02Creates ADRs during the discussion
  3. 03Adds glossary entries
  4. 04Invokes grilling and domain-modeling skills

Use cases

  1. 01Clarifying a design before implementation
  2. 02Recording decisions as ADRs
  3. 03Capturing domain terminology during planning

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/akillness/jeo-skills --skill grill-with-docs

After installing, type/grill-with-docsin Claude Code to confirm it loaded.

Details

From the project README

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

Comments

Markdown supported