CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-retro

Use when the user wants their skills graded from real session history, asks which installed skills actually work, or wants evidence-backed skill edits. Collects local sessions with collect_sessions.py, scores them against two rubrics and gates edits with score_aggregator.py.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

85%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 exceptionally well-engineered operational skill: fully executable commands, a gated five-step workflow with validation and feedback loops, and a lean body. The single significant defect is that the two referenced scorer rubric files are missing from the bundle, which both breaks progressive disclosure and makes step 2 unexecutable as shipped.

Suggestions

Ship the two referenced rubric files (scorers/efficiency.md and scorers/code-quality.md) or correct the paths — step 2 instructs judging "against both rubrics" and cannot be followed without them.

In the References and assets section, mark which files are required for the workflow (the scorers, the example JSON shapes) versus optional background reading, so a missing critical file is immediately visible.

Trim the overlap between the Hard Rules section and the step bodies (privacy, labels-only, exit 4, explicit-yes, zero-suggestions each appear twice) by shortening the rules to bare one-line imperatives.

DimensionReasoningScore

Conciseness

The body is dense and assumes competence — every step carries only non-obvious operational detail ("Exit 4 is a stop", "labels only, never invent numeric scores", chmod-0600 redaction). Not a 5 because the Hard Rules section duplicates five points already stated in the steps (privacy, labels-only, exit 4, explicit yes, zero-suggestions), tokens that could be trimmed; well above the 3 anchor since there is no concept-teaching padding.

4 / 5

Actionability

Copy-paste ready commands cover every step: the mktemp scratch-dir setup, collect_sessions.py with --out, score_aggregator.py with --emit-template and full flag combinations, diff -u for proposals, render_report.py — plus concrete edge-case guidance (insufficient_evidence label, 1–5 top_findings, --days 90 fallback). Matches the fully-executable 5 anchor.

5 / 5

Workflow Clarity

Five clearly sequenced steps with explicit validation checkpoints and feedback loops: check sessions_sampled == 0 and stop, aggregator validates labels/reasons/suggestion citations, "Exit 4 is a stop: fix what it names and re-run", and a destructive-change gate (apply edits only on explicit per-skill yes). Matches the 5 anchor's validate→fix→retry pattern despite involving batch and file-modifying operations.

5 / 5

Progressive Disclosure

Structure and signaling are good — a scripts table with roles/exit codes and a one-level-deep references section with existing references/ and assets/ files — but the two files step 2 depends on entirely, [`scorers/efficiency.md`](scorers/efficiency.md) and [`scorers/code-quality.md`](scorers/code-quality.md), do not exist anywhere in the bundle, so navigation breaks for the core scoring rubrics. Not a 4: missing required bundle files is more than a minor organization gap; not a 2 since references are clearly signaled and no content is wrongly inlined.

3 / 5

Total

17

/

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: third-person concrete actions naming the actual scripts, plus an explicit three-condition "Use when" clause covering what and when. Minor room to improve by mentioning the report output and adding synonyms like "audit" or "evaluate".

DimensionReasoningScore

Specificity

Lists several concrete third-person actions — "Collects local sessions with collect_sessions.py", "scores them against two rubrics", "gates edits with score_aggregator.py" — naming the actual scripts. Not a 5 because coverage has gaps: the report-rendering/summary step and the privacy-local-only contract are absent from the description.

4 / 5

Completeness

Explicitly answers both questions: "Use when the user wants their skills graded... asks which installed skills actually work, or wants evidence-backed skill edits" gives three concrete trigger conditions, and the "what" is stated as collect/score/gate actions. Clear match to the 5 anchor; the 4 anchor's caveat ("when could be more explicit") does not apply.

5 / 5

Trigger Term Quality

Natural trigger phrases users would plausibly say are present: "skills graded from real session history", "which installed skills actually work", "evidence-backed skill edits". Not a 5 because common synonyms like "audit my skills", "evaluate skills", or "skill quality" are missing; not a 3 since coverage goes well beyond one or two generic keywords.

4 / 5

Distinctiveness Conflict Risk

The niche — grading installed skills from real session history — is distinct with specific triggers unlikely to fire for unrelated skills. Not a 5 because it could still overlap with closely related skill-evaluation/self-eval skills unless the session-history qualifier is picked up; the description itself (scoring only what is stated) doesn't delineate those neighbors.

4 / 5

Total

17

/

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.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 2 missing

Warning

Total

14

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

engineering/skill-retro/skills/skill-retro/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.