CtrlK
BlogDocsLog inGet started
Tessl Logo

validate-skills

Validates skills in this repo against agentskills.io spec and Claude Code best practices. Use via /validate-skills command.

56

Quality

66%

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

Quality

Content

78%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 lean, well-structured validation checklist with executable guidance and a clear reporting workflow, appropriate for a single-purpose audit skill. The main improvement would be tighter wording in the one-level-deep clarification.

DimensionReasoningScore

Conciseness

The body is efficient with rule tables and an executable command, assuming Claude's competence; the one-level-deep blockquote is slightly verbose but justified to disambiguate a subtle rule, fitting the minor-trim anchor.

4 / 5

Actionability

It gives an executable discovery command (`fd -t d -d 1 . skills/`) and a concrete report-format template with PASS/FAIL examples, with only minor gaps in coverage of edge cases.

4 / 5

Workflow Clarity

"How to Run" sequences find → check → report with the per-check PASS/FAIL report acting as the validation checkpoint; no error-recovery loop is needed for a read-only audit, though the reliance on `fd` is a minor gap.

4 / 5

Progressive Disclosure

This is a simple single-purpose skill with no bundle files and no nested references; sections are well-organized and external links use markdown, satisfying the simple-skill exception for a top score.

5 / 5

Total

17

/

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 clearly states what the skill does and ties it to a distinct slash command, but the trigger guidance focuses on invocation method rather than use-when conditions, keeping completeness and trigger quality mid-range.

Suggestions

Add an explicit "Use when..." clause naming natural triggers (e.g., 'Use when authoring or linting skills, or when the user asks to validate skill format').

Include common synonyms such as lint, check, or audit to broaden natural trigger coverage.

Briefly enumerate the concrete checks performed (spec compliance, best practices) to lift specificity.

DimensionReasoningScore

Specificity

"Validates skills in this repo against agentskills.io spec and Claude Code best practices" names the domain and one concrete action (validate), but does not enumerate multiple specific checks, matching the 1-2 concrete actions anchor.

3 / 5

Completeness

The "what" is clear (validates skills against spec and best practices), but the only trigger guidance is "Use via /validate-skills command", which tells how to invoke rather than when to use it, so the "when" is only weakly implied per the cap guidance.

3 / 5

Trigger Term Quality

"validate skills" and "/validate-skills" are natural trigger terms, but coverage is thin with no common synonyms like lint, check, or audit that a user might also say.

3 / 5

Distinctiveness Conflict Risk

"Validates skills in this repo against agentskills.io spec" carves a clear niche tied to a specific slash command, with only minor overlap risk against generic linting skills.

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.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

relative_links

Relative link issues: 1 missing, 1 suspicious

Warning

Total

14

/

16

Passed

Repository
callstackincubator/agent-skills
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.