CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-reviewer

Evaluate a SKILL.md for quality. An agent that dynamically discovers the rubric files and scores the skill against each, producing one result per rubric. Use when running a skill review workflow or testing skill quality against configurable rubrics.

Quality

90%

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

The canonical home for this skill is tessl/default-skill-review

SKILL.md
Quality
Evals
Security

Quality

Content

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

A lean, highly actionable procedural skill body with clear step sequencing, exact formulas, and copy-paste output templates. Weak spots are modest: a redundant reminders section, no final verification step for results.json, and a schema reference path that does not match the bundle layout.

Suggestions

Remove or fold the 'Important reminders' bullets that duplicate Steps 1, 3, and 5 into their original steps to reclaim tokens without losing information (conciseness).

Add an explicit final verification step before writing, e.g., 'Confirm every dimension id from each rubric appears in its judge's scores and that the JSON validates against the schema' (workflow_clarity).

Fix the schema reference to the resolvable bundle path: the body cites 'schemas/results.schema.json' but the file lives at 'references/schemas/results.schema.json' (progressive_disclosure).

DimensionReasoningScore

Conciseness

The 'Important reminders' section ('Read bundle files selectively', 'Every dimension id from each rubric must appear...', 'All scores must be within scale.min–scale.max') restates rules already given in Steps 1, 3, and 5, but the body otherwise assumes competence with no concept explanations and no padding. This fits anchor 4's 'minor instances of over-explanation that could be trimmed' rather than 5's every-token-earns-its-place.

4 / 5

Actionability

Concrete and executable throughout: exact paths ('./rubrics/', './config.json'), exact formulas ('normalizedScore = (weightedScore - scale.min) / (scale.max - scale.min)'), copy-paste JSON output templates for both the evaluation object and results.json, and explicit failure handling ('set success: false and populate errorMessage'). Fully actionable guidance for an instruction-only skill.

5 / 5

Workflow Clarity

Five clearly sequenced steps (read → discover → run judges → compute → write) with an explicit error-recovery branch for failed judges and a constraint checklist ('results.json must be valid JSON conforming to schemas/results.schema.json'). However, there is no explicit verification action confirming the written output conforms before finishing — a minor validation gap matching anchor 4 rather than anchor 5's explicit validate-and-recover loop.

4 / 5

Progressive Disclosure

A well-sectioned single-file workflow whose only external reference ('schemas/results.schema.json') is one level deep, but that cited path does not resolve in the actual bundle — the schema lives at 'references/schemas/results.schema.json'. That minor navigation/organization gap fits anchor 4 ('references mostly clear; minor organization gaps') rather than 5's clean, easy navigation.

4 / 5

Total

17

/

20

Passed

Description

92%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: concrete multi-action capability statement, an explicit 'Use when' trigger clause, and a clearly distinct niche. The only headroom is in trigger synonym coverage, which is already good.

DimensionReasoningScore

Specificity

Quotes: 'Evaluate a SKILL.md for quality', 'dynamically discovers the rubric files', 'scores the skill against each, producing one result per rubric' — multiple concrete actions covering the entire workflow (discovery, scoring, per-rubric output), matching the comprehensive-coverage anchor. Not 4 because no concrete action in the chain is missing or generic.

5 / 5

Completeness

Explicit 'what' ('dynamically discovers the rubric files and scores the skill against each, producing one result per rubric') paired with an explicit trigger clause ('Use when running a skill review workflow or testing skill quality against configurable rubrics') — clearly and concretely answers both what and when, matching the anchor-5 example pattern.

5 / 5

Trigger Term Quality

Quotes: 'skill review workflow', 'testing skill quality against configurable rubrics', 'SKILL.md', 'rubric files' — good natural phrases a user would actually say. Not 5 because coverage lacks common synonym variations (e.g., 'audit a skill', 'grade a skill', 'score a skill'); not 3 because the core natural triggers are all present and specific.

4 / 5

Distinctiveness Conflict Risk

The niche — rubric-based SKILL.md quality evaluation — is distinct, and its triggers ('skill review workflow', 'configurable rubrics') are unlikely to fire competing skills. Not 4 because no closely related skill in this domain would plausibly collide on these phrases.

5 / 5

Total

19

/

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

tesslio/product-plugins

Path

default-skill-review/skills/skill-reviewer/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.