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.

68

Quality

81%

Does it follow best practices?

Impact

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 has a clear niche and explicitly covers both what the skill does and when to use it, which is its strongest aspect. However, the language leans slightly toward stylistic flair ('grilling session', 'crystallise') at the expense of concrete specificity and natural trigger terms. The description would benefit from more precise action verbs and additional natural keywords users might use.

Suggestions

Replace stylistic language like 'grilling session' and 'decisions crystallise' with more concrete action descriptions, e.g., 'Validates plan terminology against the existing domain model, identifies inconsistencies, and updates documentation.'

Add more natural trigger term variations to the 'Use when' clause, such as 'review plan', 'validate domain language', 'check plan consistency', or 'architecture decision review'.

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 language review', or 'architecture decision records'. Some terms like 'grilling session' and 'crystallise' are stylistic rather than natural trigger terms.

2 / 3

Distinctiveness Conflict Risk

The combination of plan stress-testing against a domain model, terminology sharpening, and inline documentation updates (CONTEXT.md, ADRs) creates a clear and distinctive niche that is unlikely to conflict with generic planning, code review, 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 skill that provides clear, actionable behavioral guidance for conducting domain model grilling sessions. It excels at conciseness and actionability — giving Claude specific phrases, criteria, and patterns without over-explaining. The main weakness is that the workflow is presented as a set of concurrent behaviors rather than a sequenced process, which could lead to inconsistent session flow, though for an interactive interview-style skill this is a minor concern.

Suggestions

Consider adding a brief sequenced workflow at the top: e.g., 1) Explore codebase and read existing CONTEXT.md/ADRs, 2) Identify plan's key decisions and terms, 3) Begin questioning one branch at a time, 4) Update docs as decisions crystallize — this would make the session kickoff more predictable.

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 but you seem to mean Y'), precise criteria for ADR creation (three conditions), explicit instructions to update CONTEXT.md inline rather than batching, and clear file structure conventions. These are directly executable behaviors, not abstract descriptions.

3 / 3

Workflow Clarity

The workflow is implicit rather than explicitly sequenced — the skill describes behaviors to exhibit during a session but doesn't provide a clear step-by-step sequence (e.g., start by exploring codebase → read existing CONTEXT.md → begin questioning → update docs). The 'During the session' section lists parallel concerns rather than a sequenced process. There's no explicit validation checkpoint for verifying that CONTEXT.md updates are consistent or that ADR criteria were properly evaluated.

2 / 3

Progressive Disclosure

The skill is well-structured with clear sections (what-to-do, domain awareness, during the session) and appropriately references external format files (CONTEXT-FORMAT.md, ADR-FORMAT.md) for detailed formatting — keeping the main skill lean. References are one level deep and clearly signaled. Note: bundle files were not provided, but the references are well-placed and the content is appropriately split.

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
coder/agent-tty
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.