CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

retro

Improve agent harness configuration based on recent friction points. Use when invoked as `$retro` or when the user asks for autonomous cleanup of Codex, agent harness, or migrated Claude configuration.

Quality

87%

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

SKILL.md
Quality
Evals
Security

Quality

Content

86%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, well-structured instruction-only skill: clear sequencing, explicit validation checkpoints, and concrete scope boundaries. Its gaps are minor — no executable validation commands and no stated recovery loop when validation fails.

DimensionReasoningScore

Conciseness

Every section earns its place — a terse input rule ('ask for 2-5 concrete issues'), path lists, and a six-step workflow with no explanations of concepts Claude already knows — matching the anchor-5 'lean and efficient' example; anchor 4 would require over-explanation worth trimming, and none is present.

5 / 5

Actionability

Concrete guidance throughout — specific paths (`.codex/`, `.agents/`, `AGENTS.md`), a root-cause taxonomy, three explicit validation checks, and a copy-paste report template — matching anchor 4's 'minor gaps'. Not 5 because validation is stated as an outcome ('TOML/JSON/YAML/frontmatter parses') without any executable command to perform it.

4 / 5

Workflow Clarity

The six-step sequence includes an explicit validation step with three concrete checkpoints ('parses', 'Referenced scripts or skills exist', 'No Claude-only assumptions remain'), satisfying anchor 4. Not 5 because no error-recovery feedback loop states what to do when validation fails; not 3 because checkpoints are present and explicit, not merely implied.

4 / 5

Progressive Disclosure

This is a ~50-line single-purpose skill with no bundle files (no references/, scripts/, or assets/ exist) and well-organized Input/Scope/Workflow sections where nothing belongs in a separate file, earning 5 under the simple-skill exception; anchor 4 would require organization gaps or misplaced content, which are absent.

5 / 5

Total

18

/

20

Passed

Description

82%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 that clearly and explicitly states both what the skill does and when to use it, with concrete trigger phrases and a distinct niche. The only weakness is that the capability verb ('Improve') is generic rather than enumerating the specific actions the body actually covers.

DimensionReasoningScore

Specificity

Names the domain ('agent harness configuration') with an action basis ('based on recent friction points') and cleanup targets, matching anchor 3's 'domain and 1-2 concrete actions'. Not 4 because the only verbs are generic ('Improve', 'cleanup') with no list of several specific actions; not 2 because it goes beyond bare domain naming by scoping the input and targets.

3 / 5

Completeness

Explicitly answers both: 'Improve agent harness configuration based on recent friction points' (what) and 'Use when invoked as `$retro` or when the user asks for autonomous cleanup of Codex, agent harness, or migrated Claude configuration' (when) with concrete trigger phrases — the exact anchor-5 pattern. Anchor 4 would require the 'when' to be less explicit or specific than it is.

5 / 5

Trigger Term Quality

Includes multiple natural trigger terms ('$retro', 'autonomous cleanup', 'Codex', 'agent harness', 'migrated Claude configuration'), matching anchor 4's good coverage. Not 5 because it lacks synonyms or variations users might naturally say (e.g., 'retrospective', 'fix my config', 'post-session review'); not 3 because coverage spans several distinct phrasings rather than a single generic keyword.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (harness-config retrospective scoped to Codex/agent harness/migrated Claude configuration) with distinct triggers ($retro invocation, named tools), giving minimal conflict risk per anchor 5. Not 4 because no closely related skill would plausibly claim these specific triggers.

5 / 5

Total

17

/

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

phatblat/dotfiles

Path

.agents/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.