grill-with-docs – Design & UI skill for AI agents
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
Install the grill-with-docs skill with one command
Pick the tool you use, copy the command and paste it in your terminal. The skill lands in that tool's skills folder and is ready in your next session.
Claude Code
mkdir -p ~/.claude/skills && curl -fsSL https://skill.dn1nguoi.com/z/grill-with-docs-cde5d.tgz | tar xz -C ~/.claude/skills
Call it in Claude Code: /grill-with-docs – then describe the task you want done.
Codex
mkdir -p ~/.codex/skills && curl -fsSL https://skill.dn1nguoi.com/z/grill-with-docs-cde5d.tgz | tar xz -C ~/.codex/skills
Call it in Codex: $grill-with-docs – then describe the task you want done.
Hermes Agent
mkdir -p ~/.hermes/skills && curl -fsSL https://skill.dn1nguoi.com/z/grill-with-docs-cde5d.tgz | tar xz -C ~/.hermes/skills
Call it in Hermes Agent: /grill-with-docs – then describe the task you want done.
DeepSeek
mkdir -p ~/.deepcode/skills && curl -fsSL https://skill.dn1nguoi.com/z/grill-with-docs-cde5d.tgz | tar xz -C ~/.deepcode/skills
Call it in DeepSeek: /grill-with-docs – then describe the task you want done.
SKILL.md content
When to Use
Use when this workflow matches the user request: A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
_Source: [mattpocock/skills](https://github.com/mattpocock/skills) (MIT)._
Use the installed grilling procedure to ask one meaningful question at a time. Inspect existing ADR/glossary conventions first. Record only confirmed answers in authorized project docs, mark open proposals as Proposed, preserve conflicting alternatives and review the resulting diff. Use domain-modeling only if installed and relevant; do not invent a slash-command dependency.
Example
User request:
> Use @grill-with-docs for this task: A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
Limitations
- Requires the upstream tool, account, API key, or local setup when the workflow names one.
- Does not authorize destructive, production, paid, or external-message actions without explicit user approval.
- Validate generated artifacts or recommendations against the user's real sources before treating them as final.
Related skills
- grilling – Interview the user relentlessly about a plan or design. Use when the user wants to…
- haskell-pro – Design and review Haskell types, pure domain logic, parsing, exception-safe concurrency…
- hig-components-menus – Design Apple-platform menus, buttons, toolbars and disclosure controls using the…
- hig-components-status – Apple HIG guidance for status and progress UI components including progress indicators…
- hig-foundations – Apple Human Interface Guidelines design foundations.
- hig-inputs – Design Apple-platform input interactions for touch, keyboard, pointer, Pencil…
- hig-patterns – Apple Human Interface Guidelines interaction and UX patterns.
- hig-platforms – Apple Human Interface Guidelines for platform-specific design.