CtrlK
BlogDocsLog inGet started
Tessl Logo

grill-with-docs

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

Quality

81%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

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.

DimensionReasoningScore

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.'

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
mattpocock/skills
Reviewed

Table of Contents

Is this your skill?

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.