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.

64

Quality

78%

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

100%

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 concise, actionable, and well-organized validation guide with executable commands, precise rules, and a clear reporting workflow. It respects the token budget and needs no bundle files for its scope.

DimensionReasoningScore

Conciseness

The body is lean: compact rule tables, short prose, and a copy-paste command, with no padding or explanation of concepts Claude already knows; the cross-linking blockquote earns its place as non-obvious guidance.

3 / 3

Actionability

It provides an executable command ("fd -t d -d 1 . skills/"), precise checklist rules, and a concrete report template, giving fully actionable guidance.

3 / 3

Workflow Clarity

The sequence (find skill dirs, read SKILL.md, check rules, report) is explicit and produces a structured PASS/FAIL output; the operation is read-only validation, so the destructive-ops feedback-loop cap does not apply.

3 / 3

Progressive Disclosure

No bundle files exist; the body is self-contained and well-organized into clearly headed sections, with external links properly formatted as markdown, which suits a single-purpose skill needing no external references.

3 / 3

Total

12

/

12

Passed

Description

57%

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 is clear and distinct but uses a single umbrella action and leans on command invocation rather than natural-language triggers. It states what the skill does but only implies when to use it.

Suggestions

Expand the action list beyond the single verb "validates" to concrete checks (e.g., "Checks name format, description length, link style, and progressive-disclosure structure").

Add an explicit "Use when..." trigger clause with natural phrasing such as "Use when authoring or reviewing skills, or when checking skills against the spec."

Include natural keyword variations users would actually say (e.g., "skill linting", "skill validation", "spec compliance") alongside the command invocation.

DimensionReasoningScore

Specificity

"Validates skills in this repo against agentskills.io spec and Claude Code best practices" names the domain and a concrete action, but offers only the single umbrella action "validates" rather than a list of multiple specific actions.

2 / 3

Completeness

It clearly answers "what" (validate skills against the spec and best practices) but the "when" is only implied via the command, with no explicit "Use when..." clause, which caps completeness at 2.

2 / 3

Trigger Term Quality

Terms like "validate skills" and "best practices" are relevant, but the description relies on command invocation ("Use via /validate-skills command") rather than covering natural-language keyword variations a user would say.

2 / 3

Distinctiveness Conflict Risk

The niche (linting/validating skills against the agentskills.io spec) is distinct with clear triggers and is unlikely to fire for an unrelated skill.

3 / 3

Total

9

/

12

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.