CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ponytail-review

Quality review of a change: is the logic right, is it safe, does it hold under real load, is risky code tested, is it fast enough, and is every line needed. Reads the connected code, not only the diff. Each finding is explained in plain English. Use for "review this", "code review", "review the last commit", "review my PR", "is this over-engineered", /ponytail-review.

78

Quality

98%

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

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 exemplary instruction-only skill body: lean, imperative, and fully concrete. It defines a clear four-phase workflow with an explicit verification gate before reporting, and specifies the output format down to exact line templates with a worked example. No bundle files are needed and none are referenced.

DimensionReasoningScore

Conciseness

Every line is instruction — scope rules ("Review what the user names: uncommitted or staged changes, a branch, a PR link, or files"), priorities ("Order of importance: correct, safe, holds under load, tested, fast, lean"), and output format. No concepts Claude already knows are explained; brief rationale lines like "This is a report the user asked for, so give it in full" each change behavior, so every token earns its place.

5 / 5

Actionability

Fully executable guidance for an instruction-only skill: exact output openers ("Start with `What this change does:`"), a worked four-part finding example with a real fix (`datetime.now(ZoneInfo("Europe/Berlin")).date()`), exact verdict formats ("Verdict: Ship."), the lean summary line, the not-checked line, and the empty case ("Looks good. Ship."). The output is copy-paste ready and covers the common cases.

5 / 5

Workflow Clarity

Clear four-phase sequence (Understand first → Look for → Check before you report → Output) with an explicit validation gate before reporting: "Every finding needs a concrete case ... No case, no finding" and "Re-read the lines and confirm: the caller exists, the value can really be empty, the code really is unused." This is a read-only review skill, so the destructive/batch validation cap does not apply; the checklist matches the 5 anchor.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and the ~90-line body is a cohesive single-task workflow in four numbered sections with nothing that clearly belongs in a separate file. Well-organized and easy to navigate; splitting it would hurt rather than help, so the structure matches the top anchor.

5 / 5

Total

20

/

20

Passed

Description

96%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 voice, concrete capability list, plain-English output promise, and an explicit 'Use for' clause with natural trigger phrases including the slash command. Only minor overlap risk with generic review skills keeps distinctiveness at 4.

DimensionReasoningScore

Specificity

Lists six concrete review capabilities ("is the logic right, is it safe, does it hold under real load, is risky code tested, is it fast enough, and is every line needed") plus concrete behaviors ("Reads the connected code, not only the diff", "Each finding is explained in plain English"), covering the skill's full scope. This matches the 5 anchor (multiple specific concrete actions, comprehensive coverage); a 4 would require evident gaps, and none are present.

5 / 5

Completeness

Explicitly answers both questions: what ("Quality review of a change" with the six named dimensions, reading connected code, plain-English findings) and when ("Use for 'review this', 'code review', 'review the last commit', 'review my PR', 'is this over-engineered', /ponytail-review") with concrete trigger phrases. This is the 5 anchor verbatim in structure.

5 / 5

Trigger Term Quality

Natural phrases users would actually say: "review this", "code review", "review the last commit", "review my PR", "is this over-engineered", plus the /ponytail-review slash command. Coverage spans change/commit/PR synonyms; no meaningful natural terms are missing for this domain, so it fits the 5 anchor rather than 4's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

Triggers like "code review" and "review my PR" carry minor overlap risk with other review-oriented skills, but the distinctive scope (load, tests, lean) and the "is this over-engineered" trigger give it a mostly-distinct niche. Best fit is 4 (mostly distinct; minor overlap risk), not 5's minimal conflict risk.

4 / 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

DietrichGebert/ponytail

Path

skills/ponytail-review/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.