grill-with-docs

Summary

This skill instructs an agent to conduct a structured interview ("grilling") of a plan or design while generating documentation artifacts (ADRs and glossary). It is designed to invoke two other skills sequentially: one for the grilling process and one for domain modeling.

Detected Capabilities

Trigger Keywords

Phrases that agents use to match this skill to user intent.

Use Cases

• Validate design decisions through rigorous questioning
• Generate Architecture Decision Records (ADRs) during design review
• Create domain glossary as a byproduct of design scrutiny
• Sharpen technical plans by challenging assumptions

Quality Notes

• CRITICAL: Skill content is severely incomplete — the SKILL.md body contains only 1 line of high-level instruction with no actionable detail
• No structured methodology provided for how the agent should conduct the grilling interview
• No guidance on what questions to ask, in what order, or how to evaluate responses
• No templates or examples provided for ADR or glossary generation
• No error handling or edge case guidance (e.g., what if user cannot articulate design rationale?)
• References to external skills ('grilling' and 'domain-modeling') are not named, not linked, and lack documentation on their interface
• No scope boundaries defined — unclear which types of designs/plans are in scope
• No definition of success criteria or deliverables (e.g., how many ADRs? what constitutes a complete glossary?)
• disable-model-invocation: true suggests this is a meta-skill, but purpose and usage model are unclear
• Missing documentation of how the two skill invocations coordinate or sequence