CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

consistency-check

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

Quality

75%

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 content is a strong, highly executable operational script: exact tool calls, commands, and templates, sequenced across seven phases with genuine validation feedback loops (registry validate-and-fix, re-read-before-write, empty-scope guards) and explicit verdict semantics. Its only weaknesses are minor: a few justificatory asides that could be trimmed, and a ~380-line single-file structure where the workflow-tier preamble and log formats could move to reference files. No suggestions needed — the low-scoring dimensions (conciseness, progressive_disclosure at 4) reflect trim-level refinements, not gaps.

DimensionReasoningScore

Conciseness

The body is overwhelmingly operational — tool invocations with parameters, exact commands, and report templates — with no explanation of concepts Claude already knows. A few rationale passages could be trimmed (the Phase 7 breadcrumb blockquote "A breadcrumb is a pointer left for a future session to follow...", repeated "...and that is not a PASS" justifications in Phases 1-2, and the Phase 3 4,000-lines-vs-50-greps arithmetic), fitting anchor 4 (efficient, minor instances of over-explanation) rather than anchor 5 where every token earns its place.

4 / 5

Actionability

Guidance is copy-paste ready throughout: exact tool calls ("Grep pattern=\"[entity_name]\" glob=\"design/gdd/*.md\" output_mode=\"content\" -C 3"), a fully executable bash pipeline ("git log --name-only --pretty=format: -- design/gdd/ | grep \"\.md$\" | sort -u"), the validation command "bash .claude/scripts/registry.sh validate", and complete report/log templates with literal formats like "# was: [old_value] before [date]". The only placeholders ([entity_name], [date]) are inherent runtime parameters, and specific examples cover the common cases (all four modes, all three conflict classes).

5 / 5

Workflow Clarity

Seven explicitly sequenced phases with validation checkpoints and feedback loops despite batch operations: Phase 6 mandates "run bash .claude/scripts/registry.sh validate and fix every row... before the verdict" (validate → fix → re-run), requires re-reading the registry before each Edit to anchor on current text, and defines error recovery when the script is missing. Explicit verdict logic (NOT ASSESSED / PASS / CONFLICTS FOUND / BLOCKED / COMPLETE) with empty-scope guards in Phases 1-2 prevents false PASS results — this matches anchor 5 (clear sequence, explicit validation, feedback loops for error recovery).

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and all referenced paths (design/registry/entities.yaml, .claude/scripts/registry.sh, .claude/docs/*.md) are project files the skill operates on, not nested skill references — so there is no multi-level-reference penalty. The single SKILL.md is well organized into clearly headed phases with separators, and the inline report/log templates are used on every run so belong inline. However, at ~380 lines some content is a candidate for extraction (the workflow-tier rules in the preamble, the Phase 6b reflexion-log format), fitting anchor 4 (good structure, minor organization gaps) rather than anchor 5's ideal split across well-signaled reference files.

4 / 5

Total

18

/

20

Passed

Description

53%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 states a clear, domain-specific "what" with a concrete method (grep-first), but omits any "when to use" guidance and misses the most natural trigger vocabulary (consistency, mismatch). It is distinguishable from generic skills but does not separate itself from the sibling GDD-review skill. Overall a mediocre description: informative on function, weak on triggering.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use after writing each GDD, before /review-all-gdds or /create-architecture, or when GDD values seem inconsistent' — this would raise completeness from 3 to 4-5.

Include natural trigger synonyms the skill's own name already uses: 'consistency', 'inconsistent values', 'mismatch', 'out-of-date registry' rather than only 'conflicts' and 'different stats'.

Briefly state the outputs (conflict report, optional registry corrections, failure-log entries) to broaden capability coverage and differentiate from /review-all-gdds' holistic review.

DimensionReasoningScore

Specificity

"Scan GDDs against the entity registry for cross-document conflicts" and "Grep-first approach targets conflicting sections, different stats" name the domain and two concrete actions (registry comparison, targeted grep), but coverage is incomplete — the report output, registry corrections, and per-entity/per-item modes from the body are absent, and "different stats" is vague. This matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) better than anchor 4, which expects several listed specific actions with only minor gaps.

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 skill's run timing (after writing each GDD, before review/architecture) lives only in the body. Per the rubric guideline, a missing 'Use when' clause caps completeness at 3; it is not 2 because the "what" is concrete, and not 4 because no "when" is stated at all.

3 / 5

Trigger Term Quality

Terms like "GDDs", "entity registry", "cross-document conflicts", and "conflicting sections" are relevant domain keywords a user of this project would say, but common variations are missing — notably "consistency" / "inconsistency" (the skill's own name), "mismatch", and "out of date" for the stale-registry case. Anchor 3 (some relevant keywords, missing common variations or synonyms) is the closest fit; anchor 4 would require broader natural-term coverage.

3 / 5

Distinctiveness Conflict Risk

"GDDs", "entity registry", and "cross-document conflicts" carve out a clear niche with distinct triggers, but the body references a closely related sibling skill (/review-all-gdds, holistic GDD review) that the description does not differentiate from, leaving minor overlap risk. This fits anchor 4 (mostly distinct, minor overlap with closely related skills) rather than anchor 5, which demands fully distinct triggers.

4 / 5

Total

13

/

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

Path

.claude/skills/consistency-check/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.