CtrlK
BlogDocsLog inGet started
Tessl Logo

consistency-check

Scan GDDs against the entity registry for cross-document conflicts. Grep-first approach targets conflicting sections, different stats.

64

Quality

80%

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 ./.claude/skills/consistency-check/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

88%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 tightly written, fully executable multi-phase procedure with concrete tool commands, explicit stop/validation conditions, and a verification re-run loop. The only weaknesses are minor: a few rationale sentences that could be trimmed and templates that could be offloaded to reference files in a larger bundle.

DimensionReasoningScore

Conciseness

The body is dense operational instruction — exact grep/glob commands, per-phase stop conditions, and copy-ready report templates — with only minor instances of over-explanation that could be trimmed, e.g. "This is the core optimization: instead of reading 10 GDDs × 400 lines each (4,000 lines)..." and the Phase 7 blockquote "A breadcrumb is a pointer left for a future session to follow...". It fits anchor 4 ('efficient; minor instances of over-explanation') rather than anchor 3, since nearly all tokens carry operational weight and nothing explains concepts Claude already knows.

4 / 5

Actionability

Fully executable guidance throughout: exact tool invocations ("Grep pattern=\"[entity_name]\" glob=\"design/gdd/*.md\" output_mode=\"content\" -C 3", "git log --name-only --pretty=format: -- design/gdd/ | grep \"\.md$\" | sort -u"), four explicit conflict-detection rules, a complete report template with verdict line, and exact AskUserQuestion prompts covering the common cases. This matches anchor 5 ('fully executable; copy-paste ready code or commands; specific examples cover the common cases').

5 / 5

Workflow Clarity

Seven clearly sequenced phases with explicit validation checkpoints: empty-registry and empty-scope both stop with a NOT ASSESSED verdict ("nothing was compared, so there is no PASS to give"), Phase 4 re-reads full sections to confirm each conflict before reporting, writes are permission-gated ("May I update design/registry/entities.yaml..."), and the Recovery section closes the feedback loop ("Fix the flagged GDDs, then re-run /consistency-check to confirm resolution"). This is anchor 5: explicit validation steps, error-recovery paths, and a re-run verification loop.

5 / 5

Progressive Disclosure

The single-file skill is well organized into named phases with clear headers, and its external pointers (.claude/docs/automation-modes.md, .claude/docs/workflow-modes.md, design/registry/entities.yaml) are one level deep and clearly signaled; no bundle files exist to misroute. It is anchor 4 rather than 5 because at ~350 lines some self-contained blocks — the Phase 5 report template and the Phase 6b reflexion-log format — could live in a references/ file and be linked, per anchor 4's 'minor organization gaps'.

4 / 5

Total

18

/

20

Passed

Description

65%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 gives a clear, distinctive picture of what the skill does with domain-appropriate keywords, but it omits any 'when to use' guidance and under-sells the skill's outputs (report, verdicts, registry corrections). The trailing fragment 'different stats' reads as clipped rather than informative.

Suggestions

Add a 'Use when...' clause, e.g. 'Use when a new GDD is written, before /review-all-gdds or /create-architecture, or when GDD values seem inconsistent with the registry.'

Mention the skill's outputs to broaden action coverage: '...and produces a conflict report with PASS/CONFLICTS verdicts and optional registry fixes.'

Include natural synonyms like 'inconsistencies' or 'contradictions between GDDs' so users phrasing the need either way trigger the skill.

DimensionReasoningScore

Specificity

The description names the domain ("GDDs against the entity registry") and 1–2 concrete actions ("Scan ... for cross-document conflicts", "Grep-first approach targets conflicting sections"), but coverage is not comprehensive — producing the conflict report, registry corrections, and PASS/CONFLICTS verdicts are all unstated, and "different stats" is fragmentary. It matches anchor 3 ('names domain and 1–2 concrete actions, but not comprehensive') better than anchor 4, which expects several specific actions like 'extracts text, fills forms, converts pages to images'.

3 / 5

Completeness

The 'what' is clear ("Scan GDDs against the entity registry for cross-document conflicts"), but there is no 'Use when...' clause or equivalent trigger guidance — the second sentence ("Grep-first approach targets conflicting sections, different stats") describes method, not when to invoke the skill. Per the rubric, a missing 'Use when' clause caps completeness at 3, which is exactly anchor 3 ('clear what but when is missing').

3 / 5

Trigger Term Quality

Good keyword coverage for the domain: "GDDs", "entity registry", "cross-document conflicts", "conflicting sections", and "stats" are phrases a user of this game-design project would naturally say. A few natural terms are missing — notably "consistency", "inconsistencies", and "contradictions" — which keeps it below anchor 5's 'comprehensive coverage ... including synonyms'.

4 / 5

Distinctiveness Conflict Risk

"GDDs against the entity registry" is a clear niche with distinct triggers; within this project's skill set (design-system, review-all-gdds, create-architecture) nothing else is described as a registry-vs-document conflict scan, so overlap risk is minimal. It is not anchor 4 ('minor overlap risk') because the paired jargon 'GDD' + 'entity registry' uniquely identifies this skill.

5 / 5

Total

15

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository
Donchitos/Claude-Code-Game-Studios
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.