CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

martinfrancois/build-a-skill

An Agent Skill that builds a skill with evals out of the conversation in which the agent finally got it right.

3.84x
Quality

100%

Does it follow best practices?

Impact

100%

3.84x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Overview
Quality
Evals
Security
Files

Quality

Content

100%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-constructed instruction skill: a nine-step workflow where every step is executable, every fragile operation (scaffold, evals, replay, hosted runs) has an explicit validation loop or stop rule, and detail is correctly deferred to real, clearly-signaled bundle files. The body respects the token budget while remaining copy-paste actionable throughout.

DimensionReasoningScore

Conciseness

The ~88-line body contains only steps, rules, and pointers — no explanations of concepts Claude already knows — and dense operational detail (e.g. the Tessl credit stop rule) is decision-critical rather than padded. Anchor 5 ('lean and efficient; every token earns its place') fits better than 4, which requires over-explanation that could be trimmed, and none is evident.

5 / 5

Actionability

Every step carries an executable command — `git log -1 --format=%H --before="<prompt time>"`, `cp -r "$(readlink -f <this skill's folder>)/assets/template/." <new repository>/`, `./scripts/start_skill.sh <name>`, `python3 ./scripts/validate_eval_criteria.py evals evals-reference evals-regression`, `tessl review run --threshold 100 skills/<name>/SKILL.md` — plus concrete numeric rules (at most three runs, 30-point gap, threshold 100). This matches anchor 5 (fully executable, copy-paste ready); anchor 4 would require minor gaps, and the commands are complete.

5 / 5

Workflow Clarity

Nine numbered steps in a clear sequence with explicit validation checkpoints (validate eval criteria 'until it passes', compare the replay against 'the version that stayed', 'fix every finding') and feedback loops ('fix the skill (never the prompt) and replay again'; 'At most three runs per scenario per change; if a run is stuck or a score does not move, stop and report'), ending in a done-check with required reporting. This matches anchor 5; anchor 4 would mean missing or merely implicit checkpoints, and validation is explicit at every stage.

5 / 5

Progressive Disclosure

The body is an overview workflow that keeps detail in four real one-level-deep reference files (all verified present in references/) surfaced through a 'Read it when' table, plus a real assets/template/ bundle whose README is also linked; the references do not chain to further skill documents. This matches anchor 5 (clear overview, well-signaled one-level-deep references, easy navigation) rather than 4, since organization gaps are absent.

5 / 5

Total

20

/

20

Passed

Description

100%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 model description: third-person voice, comprehensive concrete action list, explicit 'Use whenever' triggers with synonym coverage including the case where the user never says 'skill', and a 'Not for' clause that scopes it against from-scratch skill writing. It is long, but every clause is either a capability or a trigger, so there is no padding to penalize.

DimensionReasoningScore

Specificity

The description lists six concrete actions — 'captures every correction, scaffolds a repository from a template, writes the skill and at least three evals, replays the first prompt with the skill installed..., scores the evals with and without it, and installs the skill' — which is comprehensive coverage, matching anchor 5 rather than 4 (which requires minor gaps in the action list).

5 / 5

Completeness

It explicitly answers both parts: what ('Builds an Agent Skill with evals out of the current conversation...' with the concrete action list) and when ('Use whenever the user asks to turn this conversation, these corrections, or this fix into a skill...'), plus a concrete exclusion ('Not for writing a skill from scratch with no conversation behind it'). This matches anchor 5; anchor 4 would require the 'when' to be less explicit, and it is not.

5 / 5

Trigger Term Quality

Natural user phrasings are comprehensively covered with synonyms: 'turn this conversation, these corrections, or this fix into a skill', 'make the agent stop repeating a mistake', 'build, create, or extract a skill', 'the agent finally got it right', 'keep doing it this way', and even the no-keyword case ('even if they never say "skill"'). Anchor 5 fits; anchor 4 would require natural terms to be missing, and the trigger clauses anticipate them explicitly.

5 / 5

Distinctiveness Conflict Risk

It carves a clear niche — building a skill from an existing conversation's corrections — and explicitly distinguishes its nearest competitor ('Not for writing a skill from scratch with no conversation behind it'), with triggers tied to conversation-specific phrasing. Minimal conflict risk, matching anchor 5 rather than 4, since there is no meaningful overlap with related skills.

5 / 5

Total

20

/

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.

Reviewed

On this page