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.
How do I install this agent skill?
npx skills add https://github.com/akillness/jeo-skills --skill grill-with-docsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is designed to assist with architectural reviews and documentation by analyzing codebase context and terminology. It is safe to use and does not exhibit any malicious patterns or unauthorized data access behaviors.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
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/skillsskills/engineering/grill-with-docs/SKILL.md(commit3cca18b, MIT) - Project standards:
.agent-skills/skill-standardization/SKILL.md - Validator script:
.agent-skills/skill-standardization/scripts/validate_skill.sh
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/akillness/jeo-skills/grill-with-docs">View grill-with-docs on skillZs</a>