grill-with-docs
Sharpen Plans and Create Decision Documentation
Unresolved assumptions weaken plans and technical designs. This skill conducts a focused interview and uses domain modeling to produce ADRs and a glossary.
Install with my Agent
Copy this request to your Agent. It includes the canonical Skill page and manifest.
Review the Skillstore skill "grill-with-docs" from https://skillstore.io/skills/mattpocock-grill-with-docs.md and its manifest at https://skillstore.io/api/skills/mattpocock-grill-with-docs/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.Your Agent should still show its plan and request any confirmation required by the security policy.
Agent-readable resources
Use these links when an AI agent, crawler, or script needs clean context instead of reading the full page.
Test it
Using "grill-with-docs". A team must choose synchronous or event-driven order notifications.
Expected outcome:
- Decision: Use asynchronous events for order notifications while keeping payment confirmation synchronous.
- ADR: This balances response time with reliable payment feedback.
- Glossary: Order event means a durable record of an order state change.
Using "grill-with-docs". Plan organization-level access controls for an existing application.
Expected outcome:
- Key assumption: Organization membership is managed by administrators.
- ADR: Apply role checks at the service boundary.
- Glossary: Organization role means a named permission set within one organization.
- Open question: How should access change during pending invitations?
Security Audit
SafeThe sole static finding is a false positive because SKILL.md line 7 uses Markdown backticks around slash-command names, not executable shell syntax. The eight-line prompt delegates to two skills and contains no prompt injection or malicious intent.
Risk Factors
⚙️ External commands (1)
Share & cite this report
Share the versioned assessment report, neutral badge, embed card, and citations. Skillstore reports evidence without deciding whether this Skill is safe.
Copy report link
https://skillstore.io/skills/mattpocock-grill-with-docs/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportMarkdown badge
[](https://skillstore.io/skills/mattpocock-grill-with-docs?utm_source=security_passport_badge)HTML badge
<a href="https://skillstore.io/skills/mattpocock-grill-with-docs?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/mattpocock-grill-with-docs/security.svg" alt="Skillstore security assessment" loading="lazy"></a>Embed card
<iframe src="https://skillstore.io/embed/skills/mattpocock-grill-with-docs.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>Academic citations (APA · BibTeX · CFF)
APA citation
mattpocock. (2026). grill-with-docs security audit report (audit version 5) [Author version unspecified]. Skillstore. https://skillstore.io/skills/mattpocock-grill-with-docs/audits/5BibTeX citation
@techreport{mattpocock-mattpocock-grill-with-docs-2026,
author = {mattpocock},
title = {grill-with-docs security audit report (audit version 5)},
institution = {Skillstore},
year = {2026},
number = {5},
url = {https://skillstore.io/skills/mattpocock-grill-with-docs/audits/5},
note = {Author version unspecified}
}CITATION.cff
cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "grill-with-docs security audit report (audit version 5)"
version: "unspecified"
type: report
authors:
- name: "mattpocock"
date-released: "2026-07-23"
url: "https://skillstore.io/skills/mattpocock-grill-with-docs/audits/5"
identifiers:
- type: other
value: "skillstore:mattpocock-grill-with-docs:audit:5"
description: "Skillstore immutable audit report identifier"
Skillstore Score
Why this score Evidence Confidence: HighWhat You Can Build
Review a technical proposal
Expose assumptions and unresolved choices before an engineering team commits to implementation.
Refine a feature plan
Clarify users, workflows, constraints, and terminology before a feature enters delivery.
Document architecture decisions
Compare alternatives, record tradeoffs, and establish shared domain language for a system design.
Try These Prompts
Use grill-with-docs to interview me about this plan: [plan]. Identify assumptions and create ADRs and a glossary as decisions emerge.
Run grill-with-docs on this feature design: [design]. Focus on users, boundaries, failure cases, dependencies, and unresolved decisions.
Use grill-with-docs to compare [option A] and [option B] for [system]. Question constraints, document tradeoffs, and record the selected decision.
Run an advanced grill-with-docs session for [domain]. Challenge entities, invariants, workflows, ownership boundaries, failure modes, and terminology. Produce ADRs and a glossary.
Best Practices
- Provide the current plan, constraints, stakeholders, and known uncertainties before starting.
- Answer follow-up questions with concrete evidence and state when information is unknown.
- Review each ADR and glossary term before treating the documentation as final.
Avoid
- Do not use the session when you only need a quick factual answer.
- Do not hide fixed constraints or decisions that are no longer open.
- Do not accept generated ADRs without checking ownership, consequences, and unresolved risks.
Frequently Asked Questions
What does this skill review?
What documentation does it create?
Does it require other skills?
Can it implement the final plan?
What should I provide before starting?
Should I accept every generated decision?
Developer Details
Author
mattpocockLicense
MIT
Skillstore revision
r2
Version notice
The author did not declare a version.
Ref
ebdfe608f5de2b66ff37ab4af12af8ac4f5e8006
Maintenance freshness
7/25/2026
Usage
44 downloads · 90 views
File structure
📄 SKILL.md