CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

grill-with-docs

Grilling session that challenges your plan against the project's documented domain language and decision records, sharpens terminology, and updates the glossary and ADRs inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.

Quality

81%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured, token-efficient interview skill with genuinely concrete guidance (example utterances, explicit ADR gate, lazy file-creation rules). Its main defect is that both format sidecars it instructs the agent to use are absent from the bundle, leaving the glossary and ADR write steps unexecutable as written.

Suggestions

Ship ADR-FORMAT.md and GLOSSARY-FORMAT.md in the bundle (or inline their formats into SKILL.md) so the 'Use the format in...' instructions are actually followable.

Delete the duplicated sentence about AGENTS.md pointing at both locations — state it once in the Domain awareness section.

Add an explicit post-update verification step (e.g. re-read the touched glossary section or docs/adr/INDEX.md to confirm consistency after inline edits).

DimensionReasoningScore

Conciseness

The body is lean and prescriptive throughout — file paths, challenge heuristics, and a three-condition ADR gate with no explanations of concepts Claude already knows. Not 5 because the Domain awareness section states the same fact twice back-to-back ('both of them pointed at from the root AGENTS.md' followed by 'The root AGENTS.md is the agent manual, and it points at both'), and the attribution footer adds tokens that serve no runtime purpose.

4 / 5

Actionability

Guidance is concrete and executable for an instruction-only skill: exact doc paths (docs/domain-glossary.md, docs/adr/INDEX.md), copy-ready challenge utterances ('Your glossary defines 'cancellation' as X, but you seem to mean Y — which is it?'), and a bolded three-part ADR test. Not 5 because the glossary/ADR write procedures defer to format files that are not in the bundle, and the INDEX.md update step ('says what is currently binding') is left implicit.

4 / 5

Workflow Clarity

The session flow is clearly sequenced — interview one question at a time, explore the codebase when a question is answerable, challenge terms, update the glossary inline, offer ADRs only when all three gate conditions hold — with an explicit wait-for-feedback checkpoint and a three-condition decision gate. Not 5 because there is no verification step after inline updates (e.g. re-reading the glossary for consistency) and the order of the five 'During the session' techniques relative to each other is left open.

4 / 5

Progressive Disclosure

Section structure is good and references are clearly signaled at one level deep ([ADR-FORMAT.md](./ADR-FORMAT.md), [GLOSSARY-FORMAT.md](./GLOSSARY-FORMAT.md)), but neither file — nor the cited .agents/skills/LICENSE-mattpocock-skills.md — exists in the bundle. Core instructions ('Use the format in [GLOSSARY-FORMAT.md]') point at missing files, which is a functional navigation failure beyond the 'minor organization gaps' of the 4 anchor.

3 / 5

Total

15

/

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: it states three concrete capabilities in third person and closes with an explicit, well-phrased 'Use when' trigger clause. Trigger coverage and distinctiveness are good but not exhaustive, and the core interview mechanic is implied rather than named as an action.

Suggestions

Add one or two natural trigger variants (e.g. 'review my plan', 'interrogate my design') to broaden keyword coverage.

Replace or supplement the framing noun 'Grilling session' with an explicit action verb (e.g. 'Interviews you about...') so the core mechanic reads as a capability.

DimensionReasoningScore

Specificity

Names three concrete actions with clear objects — 'challenges your plan against the project's documented domain language and decision records, sharpens terminology, and updates the glossary and ADRs inline' — which matches 'several specific actions; minor gaps'. Not 5 because the core interview/questioning mechanic is only implied by the framing word 'Grilling session', leaving a coverage gap.

4 / 5

Completeness

Explicitly answers both: what ('challenges... sharpens terminology, and updates the glossary and ADRs inline') and when ('Use when user wants to stress-test a plan against their project's language and documented decisions') with a concrete trigger phrase. This matches the 5 anchor directly; the 4 anchor's 'when could be more explicit' does not apply.

5 / 5

Trigger Term Quality

Includes natural phrases users would say — 'stress-test a plan', 'glossary', 'ADRs', 'decision records', 'documented decisions', 'terminology'. Not 5 because common variations like 'review my plan', 'critique my design', or 'ubiquitous language' are missing, so coverage is good rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

The niche — stress-testing a plan specifically against documented domain language and ADRs — is clearly distinguishable, with distinct triggers. Not 5 because it could still overlap with generic planning-review or code-review skills that also interrogate designs.

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 possibly missing (./ADR-FORMAT.md, ./GLOSSARY-FORMAT.md)

Warning

Total

15

/

16

Passed

Repository

agranado2k/ai-report-platform

Path

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