Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.
85
81%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
75%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description effectively communicates a distinct skill with a clear 'Use when' clause, making it strong on completeness and distinctiveness. However, it leans on slightly abstract/stylistic language ('grilling session', 'crystallise') rather than maximally concrete actions, and could benefit from broader trigger term coverage. The second-person voice ('your plan') should be revised to third person per the rubric guidelines.
Suggestions
Replace second-person phrasing ('your plan') with third person (e.g., 'Challenges a plan against the existing domain model') to comply with voice guidelines.
Add more natural trigger term variations such as 'review plan', 'validate architecture', 'domain language review', or 'check plan against domain model' to improve discoverability.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain ('plan', 'domain model', 'terminology') and some actions ('challenges your plan', 'sharpens terminology', 'updates documentation'), but uses somewhat abstract language like 'grilling session' and 'decisions crystallise' rather than listing precise concrete actions. | 2 / 3 |
Completeness | Clearly answers both 'what' (challenges plan against domain model, sharpens terminology, updates CONTEXT.md and ADRs) and 'when' (explicit 'Use when user wants to stress-test a plan against their project's language and documented decisions'). | 3 / 3 |
Trigger Term Quality | Includes some relevant terms like 'stress-test', 'plan', 'domain model', 'CONTEXT.md', 'ADRs', and 'documented decisions', but misses common natural variations a user might say such as 'review plan', 'challenge assumptions', 'domain-driven design', or 'architecture review'. Some terms like 'grilling session' and 'crystallise' are stylistic rather than natural trigger terms. | 2 / 3 |
Distinctiveness Conflict Risk | The combination of domain model validation, terminology sharpening, and inline documentation updates (CONTEXT.md, ADRs) creates a clear niche that is unlikely to conflict with generic planning or documentation skills. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, well-crafted skill that provides concrete behavioral guidance for a domain-grilling session. It excels at conciseness and actionability, giving Claude specific phrases, decision criteria, and file conventions without over-explaining. The main weakness is that the workflow is presented as a collection of concurrent behaviors rather than a sequenced process, which could leave ambiguity about session structure and completion criteria.
Suggestions
Consider adding a brief explicit workflow sequence or session structure (e.g., 'Start by exploring existing CONTEXT.md and ADRs → Walk through the plan branch by branch → Wrap up with a summary of resolved terms and decisions') to improve workflow clarity.
Add a lightweight completion/validation checkpoint, such as 'Before ending the session, summarize all resolved terms and any new ADRs, and confirm with the user that nothing was missed.'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section earns its place — no explanation of what grilling sessions are, no padding about why domain modeling matters. The skill assumes Claude understands DDD concepts and jumps straight to actionable behavioral instructions. The file structure examples are minimal but necessary to show the convention. | 3 / 3 |
Actionability | The skill provides highly specific, concrete guidance: exact phrases to use when challenging terminology ('Your glossary defines X as...'), precise criteria for ADR creation (three-part test), inline update instructions, and clear file structure conventions. Each section tells Claude exactly what to do in specific situations. | 3 / 3 |
Workflow Clarity | The session flow is implicit rather than explicitly sequenced — it describes behaviors (challenge glossary, sharpen language, discuss scenarios, cross-reference code, update CONTEXT.md) but doesn't define a clear ordering or when to transition between phases. There's no explicit validation checkpoint for verifying that updates to CONTEXT.md are consistent or that the grilling session has reached sufficient coverage before concluding. | 2 / 3 |
Progressive Disclosure | The skill is well-structured with clear sections, and appropriately references external format files (CONTEXT-FORMAT.md, ADR-FORMAT.md) for detailed formatting rather than inlining them. References are one level deep and clearly signaled. However, bundle files weren't provided so we can't verify the referenced paths exist — but the structure itself is sound. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
7014111
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.