CtrlK
BlogDocsLog inGet started
Tessl Logo

cross-validate-artifacts

Cross-validate documentation and artifacts across the codebase for consistency, conflicts, and contradictions. Use when users ask to "cross-validate", "validate docs", "check documentation consistency", "audit documentation", or find conflicts/contradictions in docs. Supports automatic fixing with "validate and fix" argument. Runs parallel subagents for efficient validation across categories (domain-models, agent-system, tech-stack, architecture, cli-commands). Part of the Shep autonomous SDLC platform — https://shep.bot

62

Quality

73%

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/cross-validate-artifacts/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 provides a well-sequenced, actionable validation and fix workflow with concrete tool directives and output formats, and appropriate confirmation/validation checkpoints for a batch operation. Its weaknesses are redundancy with the description, schematic rather than copy-ready subagent instructions, and a fully inlined structure with no progressive disclosure to reference files.

Suggestions

Remove the Trigger section (it repeats the frontmatter description verbatim) and the 'Launch 5 subagents simultaneously' list (it re-enumerates the Step 2 table), keeping the body tight.

Provide concrete, copy-ready subagent prompt templates for the validation and fix subagents instead of the schematic 'Launch 5 subagents' block.

Move the per-category 'Validation Checks' detail and the Example Output into references/ files (e.g., references/checks.md and references/example-output.md) and link them from the body to improve progressive disclosure.

DimensionReasoningScore

Conciseness

The body is mostly tight tables and checklists, but the Trigger section duplicates the frontmatter description nearly verbatim, the 'Launch 5 subagents simultaneously' block re-enumerates the Step 2 category table, and the long Example Output and Notes sections pad the file. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the efficient level 4.

3 / 5

Actionability

Concrete, executable guidance dominates: 'Use the Task tool with subagent_type=Explore', a category-to-files comparison table, exact output table schemas, and fix safety rules ('Read before edit', 'Apply minimal, targeted edits using the Edit tool'). It falls short of a 5 because the subagent launch blocks are schematic lists rather than actual subagent prompts to copy.

4 / 5

Workflow Clarity

Steps 1-5 are clearly sequenced with most checkpoints present: ask 'Would you like me to fix these violations?' before fixing (skipped only with the fix argument), 'Verify after fix: Ensure the fix doesn't introduce new conflicts', and post-fix re-validation. The re-run validation step is only 'optionally', which is the minor validation gap that keeps it below the explicit-feedback-loop anchor.

4 / 5

Progressive Disclosure

The body is well-sectioned but entirely monolithic — no references/ or scripts/ bundle files exist, and everything (per-category checklists, example output, fix guidelines) is inlined in one ~215-line file. This fits 'some structure but could be better organized... content that should be separate is inline'; it is above level 2 because the sections are clearly organized, but the detailed category checks and example output clearly could live in reference files.

3 / 5

Total

14

/

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/when structure, natural trigger phrases, and specific capability statements including the fix mode. Its only weaknesses are a vague use of 'artifacts', an implementation detail ('Runs parallel subagents'), and a few missing synonyms users might naturally say.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'Cross-validate documentation and artifacts... for consistency, conflicts, and contradictions', 'Supports automatic fixing with "validate and fix" argument' — plus five named validation categories. It stops short of a 5 because 'artifacts' is undefined and 'Runs parallel subagents' is implementation detail rather than a capability.

4 / 5

Completeness

It clearly answers both questions: the 'what' is stated up front ('Cross-validate documentation and artifacts across the codebase for consistency, conflicts, and contradictions') and the 'when' is explicit ('Use when users ask to "cross-validate", "validate docs"...'). Concrete trigger phrases and the fix-mode argument make both halves explicit, matching the top anchor.

5 / 5

Trigger Term Quality

Natural trigger phrases are well covered: '"cross-validate"', '"validate docs"', '"check documentation consistency"', '"audit documentation"', 'find conflicts/contradictions in docs'. A few common variations users would say (e.g., 'docs out of sync', 'documentation drift', 'inconsistent docs') are missing, so it is not a 5.

4 / 5

Distinctiveness Conflict Risk

Documentation cross-validation with five named categories is a clear niche with distinct triggers. There is minor overlap risk with generic doc-review or audit skills, which keeps it below the top anchor.

4 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
shep-ai/shep
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.