CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

consistency-check

Verifies the V-Model artifact graph is intact: BA sections, Epics, Features, Success Criteria, ADRs, arc42 sections, PLANs, Backlog, Wayfinder rows, and code references. Two modes: syntactic (links, IDs, Refs) and semantic (content coherence via an agent). Default syntactic at the end of every skill phase. Semantic before release or on explicit request. Use this skill when the user mentions "consistency check", "graph check", "check references", "dead links", "orphan features", "graph-health", or when another V-Model skill completes a phase and wants to verify the artifact graph before handoff.

Quality

83%

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

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

An unusually actionable and well-sequenced orchestration skill with strong validation loops, escalation rules, and a per-finding fix dispatch table. Its main weaknesses are token efficiency and file structure: the Mode A checks are restated as invariants in the same body, and the invariants reference plus caps table should be moved to reference files with the body keeping a summary and links.

Suggestions

Move the full Invariants reference section (~140 lines) into a references/ file (e.g. references/graph-invariants-summary.md) and keep only the invariant IDs and one-line descriptions in SKILL.md, since the body already declares graph-invariants.md as the source of truth.

De-duplicate the Mode A "8 quick-check items" against the Invariants reference by describing each check once and cross-referencing its invariant ID (e.g. "Dead links (E-1)"), cutting the body by roughly 80-100 lines.

Move the Caps table (a declared mirror of project-conventions' canonical specs) into a reference file and have the script's ARTIFACT_CAPS documented there, keeping only the tolerance rule and the link in SKILL.md.

DimensionReasoningScore

Conciseness

The body is ~640 lines with no padding about concepts Claude already knows, but it duplicates content: the Mode A "8 quick-check items" are restated nearly verbatim in the Invariants reference (e.g. dead links / E-1, backlog completeness / E-12, ADR references / E-3), and the Caps table is an acknowledged mirror of another file ("the table below is a mirror and must be kept hand-aligned"). The templated console-report block with {n} placeholders could also be tightened.

3 / 5

Actionability

Guidance is fully concrete and executable: exact glob patterns for node discovery ("_devprocess/requirements/epics/EPIC-*.md"), exact frontmatter fields to parse ("feature-refs, adr-refs, fix-refs, imp-refs"), a per-finding-type fix dispatch table, exact marker syntax ("FIXME(stub): <reason> -- see FIX-{ee}-{ff}-{nn}"), and copy-paste commands ("bash <DIA-checkout>/tools/install-git-hooks.sh").

5 / 5

Workflow Clarity

The six-step Workflow is clearly sequenced with an abort condition if structure detection fails, and Mode C is a genuine feedback loop: load -> triage -> per-finding fix -> re-check (Mode A re-run) -> commit confirmation -> follow-up, with AskUserQuestion checkpoints at every step. Validation for risky batch behavior is explicit (escalation on shared-infrastructure or substance-deleting fixes, non-auto-fixable findings left for human triage) and a quality-gates checklist guards completion.

5 / 5

Progressive Disclosure

Section structure is clear, but content that clearly belongs in reference files is inlined: the full ~140-line invariants reference (whose stated source of truth is skills/project-conventions/references/graph-invariants.md) and the mirrored caps table both live in the SKILL.md body. External file pointers are plain code paths rather than clearly signaled navigable references, and no bundle files (references/, scripts/, assets/) exist to offload this detail.

3 / 5

Total

16

/

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 with explicit what and when clauses, concrete artifact enumeration, and an explicit trigger-term list. It would benefit from folding the body's additional keywords (e.g. "Konsistenzpruefung", "backlog health", "V-Model integrity") into the trigger list and slightly narrowing the generic "check references"/"dead links" triggers to the V-Model context.

DimensionReasoningScore

Specificity

Enumerates concrete checked artifacts ("BA sections, Epics, Features, Success Criteria, ADRs, arc42 sections, PLANs, Backlog, Wayfinder rows, and code references") and names both check modes ("syntactic (links, IDs, Refs) and semantic (content coherence via an agent)"). The core action "Verifies the V-Model artifact graph is intact" is slightly generic relative to the anchor-5 examples of multiple distinct operations, so minor coverage gaps remain.

4 / 5

Completeness

Explicitly answers both what (verifies the V-Model artifact graph via syntactic and semantic modes, with default-run timing rules) and when, with a concrete "Use this skill when the user mentions..." clause listing trigger phrases. This matches the anchor-5 example pattern of capabilities followed by explicit trigger conditions.

5 / 5

Trigger Term Quality

Includes natural phrases users would say ("consistency check", "graph check", "check references", "dead links", "orphan features", "graph-health") plus a programmatic trigger ("when another V-Model skill completes a phase"). Some natural variations are missing, e.g. "Konsistenzpruefung" and "backlog health" appear only in the body's Keywords section, not the description.

4 / 5

Distinctiveness Conflict Risk

The V-Model artifact-graph niche is distinct and the inter-skill trigger is purpose-built. However, generic phrases like "check references" and "dead links" could plausibly fire in non-V-Model contexts (general link linting), a minor overlap risk with generic lint/checker skills.

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

skill_md_line_count

SKILL.md is long (657 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

salemaziel/digital-innovation-agents

Path

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.