One-click install
npx skills add https://github.com/trystan2k/favoritable-old --skill grill-with-docs-trystan2k
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/trystan2k/favoritable-old/tree/main/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/trystan2k/favoritable-old --skill grill-with-docs-trystan2k

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the risk of building features that conflict with your project's existing domain terminology, undocumented architectural decisions, or established domain rules, which often leads to rework, misalignment, and wasted engineering effort.

Core Features & Use Cases

  • Domain Alignment Checks: Automatically cross-references your plan against existing CONTEXT.md glossary terms and ADRs to catch terminology mismatches and contradictions with documented decisions.
  • Terminology Sharpening: Identifies vague or overloaded terms in your plan and proposes precise, project-aligned alternatives to ensure consistent language across the team.
  • Inline Documentation Updates: Updates CONTEXT.md and creates ADRs in real time as decisions are finalized, so your project documentation stays in sync with planning progress.
  • Use Case: For example, when designing a new order cancellation feature, the Skill will flag if your plan uses "cancel" to refer to partial cancellations when the project glossary defines "cancellation" as a full order void, prompting you to clarify the term or adjust your plan to match existing definitions.

Quick Start

Use the grill-with-docs skill to stress-test your new user profile deletion feature against the project's existing domain glossary and recorded ADRs.

Frequently Asked Questions about grill-with-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate new feature plans against existing domain documentation?

To validate feature plans against domain documentation, cross-reference your design choices with existing CONTEXT.md glossary terms and ADRs. This catches terminology mismatches and contradictions with documented architectural decisions to prevent rework and misalignment.

What is domain terminology alignment in software planning?

Domain terminology alignment ensures consistent language across a project by cross-referencing new plans against existing CONTEXT.md glossary terms. It identifies vague or overloaded terms and proposes precise, project-aligned alternatives to maintain shared understanding.

How do I keep CONTEXT.md and ADRs updated during planning sessions?

You can keep CONTEXT.md and ADRs updated during planning sessions by using inline documentation updates. As decisions are finalized, the documentation is updated in real time to stay in sync with planning progress.

When do I need to stress-test plans against project domain docs?

You need to stress-test plans against domain docs when designing features that might conflict with established domain rules or architectural decisions. This avoids building features that contradict existing terminology, which leads to wasted engineering effort.

Can I catch terminology contradictions in my software planning workflow?

Yes, you can catch terminology contradictions in your software planning workflow by automatically cross-referencing your plan against existing project glossaries. It flags mismatches, such as using a term differently than the documented definition.

Does plan validation work without existing ADRs or a context glossary?

Plan validation is most effective with existing ADRs and a CONTEXT.md glossary. Without them, the Skill lacks the project-specific context needed to catch contradictions, enforce consistent domain language, and align design choices.