CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

60

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.cursor/skills/grill-with-docs/SKILL.md

The canonical home for this skill is grill-with-docs in mattpocock/skills

SKILL.md
Quality
Evals
Security

Quality

Content

60%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a lean, well-organized interview process with concrete example dialogue and good decision gates, scoring well on conciseness and workflow clarity. Its main defects are that both referenced format files are missing from the bundle — undermining actionability and progressive disclosure — and the directory-structure examples are partially redundant.

Suggestions

Add the referenced CONTEXT-FORMAT.md and ADR-FORMAT.md to the bundle (or inline the formats directly in SKILL.md) — the body twice defers to files that do not exist.

Collapse the two ASCII directory trees into one annotated example showing the single-context and multi-context (CONTEXT-MAP.md) layouts, saving ~20 lines without losing information.

Add an explicit termination condition for the session, e.g. a checklist for confirming shared understanding before wrapping up.

DimensionReasoningScore

Conciseness

Largely lean, imperative instructions with no explanation of concepts Claude already knows — e.g. "Interview me relentlessly", "Create files lazily — only when you have something to write". The two ASCII directory trees are the main trimming opportunity: the multi-context tree largely restates the first with per-directory repetition, which is minor over-explanation rather than the padding of anchor 3.

4 / 5

Actionability

The interview guidance itself is concrete — example challenges ("Your glossary defines 'cancellation' as X, but you seem to mean Y — which is it?"), a crisp three-part ADR test, and the one-question-at-a-time rule. But the key details for the file-update actions are missing: "Use the format in [CONTEXT-FORMAT.md](./CONTEXT-FORMAT.md)" and "[ADR-FORMAT.md](./ADR-FORMAT.md)" point to files that do not exist in the bundle, so the update formats — a key detail — are unavailable, matching anchor 3's 'missing key details' rather than anchor 4's 'minor gaps'.

3 / 5

Workflow Clarity

A clear sequenced process: explore the codebase/docs first ("If a question can be answered by exploring the codebase, explore the codebase instead"), ask questions one at a time waiting for feedback, resolve terms inline ("Don't batch these up — capture them as they happen"), with a decision gate for ADRs ("If any of the three is missing, skip the ADR"). Not a 5 because there is no explicit checkpoint for when the session is complete or how to verify 'shared understanding' has actually been reached beyond "until we reach a shared understanding".

4 / 5

Progressive Disclosure

Both cross-references — "[CONTEXT-FORMAT.md](./CONTEXT-FORMAT.md)" and "[ADR-FORMAT.md](./ADR-FORMAT.md)" — are one level deep and clearly signaled, but neither file exists in the bundle (no references/, scripts/, assets/ directories and no top-level format files), so navigation is broken for the very content the body defers to. Per the guideline to score against the actual bundle structure, dangling references make this score at the 'references present but unusable' level rather than anchor 3's merely-not-clearly-signaled or anchor 4's minor organization gaps.

2 / 5

Total

13

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person, concise, concrete about both capabilities and artifacts, with an explicit 'Use when...' trigger clause covering what and when. The only weaknesses are a few missing natural trigger synonyms and modest overlap risk with generic plan-review skills.

DimensionReasoningScore

Specificity

Quotes several concrete actions — "challenges your plan against the existing domain model", "sharpens terminology", "updates documentation (CONTEXT.md, ADRs) inline" — each tied to named artifacts. Not a 5 because the interviewing/codebase-exploration behavior implied by 'grilling session' is gestured at rather than listed, leaving minor coverage gaps.

4 / 5

Completeness

Explicitly answers both: what — "Grilling session that challenges your plan... sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline" — and when — "Use when user wants to stress-test a plan against their project's language and documented decisions". Both are concrete and clearly stated, matching anchor 5; anchor 4's 'when could be more specific' does not apply since the trigger clause is explicit and detailed.

5 / 5

Trigger Term Quality

Good natural keywords: "stress-test a plan", "project's language", "documented decisions", "grilling". Missing common synonyms a user might say — 'review my plan', 'critique my design', 'glossary', 'ubiquitous language', 'ADR' alone — so it falls short of the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

A clear DDD-flavored niche ("domain model", "CONTEXT.md, ADRs", "terminology") that is mostly distinct, but the trigger "stress-test a plan" could plausibly fire for generic plan-review or critique skills, giving minor overlap risk — anchor 4 rather than 5.

4 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

SnowingFox/ai-skills

Path

.cursor/skills/grill-with-docs/SKILL.md

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.