CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

retro

Use when running the retrospective on a piece of work that has just finished — the retro, normally the step straight after `prep-pr` opens the pull request — to write and commit the session-metrics card for the branch, read what the session actually cost against the difficulty declared before it started, and turn that into concrete changes to the skills, `AGENTS.md`, the wiki, the tests or the brief. Also the owner of the card — nothing else writes one carrying the pull request's identity.

Quality

92%

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

88%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 dense, highly operational skill body: every step is executable with exact commands, validation gates, and failure fallbacks, and detail is properly deferred to a real reference file. Its only shortcomings are minor — a few prose sections that could be trimmed and a signal table whose content overlaps the bundled reference.

DimensionReasoningScore

Conciseness

The body is efficient — it explains only repo-specific failure modes ("a `git add` of the whole of it sweeps in anything a concurrent session left there") and never concepts Claude already knows — but a few sections could be tightened, e.g. the "Where this sits" prose and the twice-visited transcripts-absent rationale, leaving minor over-explanation rather than the leanest possible form.

4 / 5

Actionability

Fully executable throughout: copy-paste bash for every step (`bun run --cwd tools/pr-metrics card -- --resolve-issue`, the branch-slug `tr -c 'a-zA-Z0-9._-' '-'` transform, the `grep -c '^<details><summary>Session metrics'` duplicate check), exact flag semantics, and a complete `RETRO.md` template covering the common cases.

5 / 5

Workflow Clarity

A clearly sequenced Steps 1–7 workflow with explicit validation and recovery: environment probes before Step 1, the duplicate-block check before appending to the PR body ("read the body out and append to it — never compose a new one"), and per-failure fallbacks ("No `gh`: write the card with whatever identity you know and leave the block in a file").

5 / 5

Progressive Disclosure

Good structure with a single, verified, one-level reference (`references/card-signals.md`) clearly signaled ("Read it before Step 3") and external detail correctly deferred to `wiki/conventions/session-metrics.md` and `tools/pr-metrics/README.md`; however, the 330-line body's Step 4 signal table overlaps the reference file's role and some of it could be split out, leaving minor organization gaps.

4 / 5

Total

18

/

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 dense, trigger-first description that explicitly states both when to use the skill and what it produces, with concrete named artifacts and an ownership boundary that disambiguates it from sibling skills. Its only weakness is missing a few natural trigger variations a user might say.

DimensionReasoningScore

Specificity

The description lists multiple concrete, verb-led actions with named artifacts — "write and commit the session-metrics card for the branch", "read what the session actually cost against the difficulty declared before it started", "turn that into concrete changes to the skills, `AGENTS.md`, the wiki, the tests or the brief" — covering the skill's whole job with no consequential gaps, matching the comprehensive-coverage anchor.

5 / 5

Completeness

It opens with an explicit trigger clause ("Use when running the retrospective on a piece of work that has just finished") and pairs it with three concrete capabilities, explicitly and clearly answering both what the skill does and when to use it.

5 / 5

Trigger Term Quality

Good natural-term coverage including the synonym pair "the retrospective"/"the retro", "session-metrics card", and the pipeline trigger "`prep-pr` opens the pull request"; a few common variations (e.g. "postmortem", "session cost") are missing, so it sits at good-but-not-comprehensive.

4 / 5

Distinctiveness Conflict Risk

A clear niche (the step straight after `prep-pr` on a finished pull request) plus an explicit ownership boundary — "Also the owner of the card — nothing else writes one carrying the pull request's identity" — keeps conflict risk with neighbouring skills minimal.

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

englishstreetventures/englishstreetventures.com

Path

.claude/skills/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.