CtrlK
BlogDocsLog inGet started
Tessl Logo

grill-with-docs

Stress-test a plan against the project’s domain model and update its documentation as terminology settles. Use when a plan needs to be challenged against existing context or ADRs.

59

Quality

68%

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 ./.agents/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

67%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 skill body is a well-structured, instruction-only skill that stays lean and gives concrete interview heuristics with a clear ADR gate. Its main weakness is that the two referenced format files are missing from the bundle, which both degrades actionability (Claude cannot follow the format directive) and weakens progressive disclosure.

Suggestions

Add the referenced CONTEXT-FORMAT.md and ADR-FORMAT.md files to the bundle so the 'Use the format in ...' directives are actually followable.

Expand the description with one or two more concrete actions and a broader set of natural trigger phrases (e.g., 'design review', 'glossary', 'domain language') to lift specificity and trigger-term quality from 4 to 5.

Tighten the two ASCII file-structure trees — the multi-context example could be condensed — to nudge conciseness toward the lean level-5 anchor.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence — it avoids explaining what ADRs or glossaries are and uses compact custom tags (<what-to-do>, <supporting-info>); the two ASCII file-structure trees are useful rather than padded, though they could be trimmed slightly, keeping it below the lean 'every token earns its place' level 5.

4 / 5

Actionability

Guidance is largely concrete — one-question-at-a-time pacing, named challenge patterns with example quotes, and a precise three-condition ADR gate — but the repeated directive 'Use the format in [CONTEXT-FORMAT.md]' / '[ADR-FORMAT.md]' points to files that are not present, leaving key format details missing and making the guidance incomplete.

3 / 5

Workflow Clarity

A clear flow is present (explore codebase → challenge against glossary/code → resolve terms → update CONTEXT.md inline → optionally offer ADRs) with checkpoints like the one-question-at-a-time feedback loop and the three-condition ADR gate; it is not a destructive/batch operation so the cap-at-3 rule does not apply, but the sequence is heuristic rather than a strict numbered procedure, leaving it below level 5.

4 / 5

Progressive Disclosure

Structure is good: a concise what-to-do section plus well-organized supporting sections, and references to CONTEXT-FORMAT.md and ADR-FORMAT.md are clearly signaled and one level deep; it stays at 4 rather than 5 because those referenced files do not exist in the bundle, so the navigation leads to dead ends.

4 / 5

Total

15

/

20

Passed

Description

70%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.

The description is well-formed: third-person voice, explicit 'Use when' trigger, and a clear dual purpose of stress-testing plans and updating domain documentation. It is slightly under-specific on the range of concrete actions and trigger variations, which caps several dimensions at 4 rather than 5.

DimensionReasoningScore

Specificity

Names the domain (domain model, documentation, ADRs) and two concrete actions — 'Stress-test a plan' and 'update its documentation as terminology settles' — which matches the anchor for 1-2 concrete actions but not comprehensive coverage, falling short of the several specific actions at level 4.

3 / 5

Completeness

Explicitly answers both 'what' ('Stress-test a plan... and update its documentation') and 'when' ('Use when a plan needs to be challenged against existing context or ADRs'), with the 'when' clause reasonably specific but not as rich in concrete trigger variations as the level-5 example.

4 / 5

Trigger Term Quality

Includes natural, sayable terms — 'plan', 'challenge', 'existing context', 'ADRs', 'terminology', 'domain model' — giving good keyword coverage, though it misses some common phrasings a user might offer, keeping it below the comprehensive synonym/extension coverage of level 5.

4 / 5

Distinctiveness Conflict Risk

Targets a fairly distinct niche — challenging plans against a project's domain model and ADRs — with mostly distinct triggers and only minor overlap risk with adjacent design/planning skills; not yet the unmistakable niche with minimal conflict risk of level 5.

4 / 5

Total

15

/

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 2 missing

Warning

Total

15

/

16

Passed

Repository
EpicenterHQ/epicenter
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.