CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ponytail-review

Quality review of a diff: bugs, security, real load, missing tests, speed, and what to delete. Each finding says what goes wrong and how to fix it.

67

Quality

84%

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

The canonical home for this skill is ponytail-review in DietrichGebert/ponytail

SKILL.md
Quality
Evals
Security

Quality

Content

96%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 lean and actionable review recipe: a clear understand-look-verify-report workflow with an explicit validation gate before reporting, concrete finding taxonomy, and a fully specified output format demonstrated by a worked example. The only structural improvement would be offloading some supporting detail (e.g. the worked example) to a reference file to slim the main body.

DimensionReasoningScore

Conciseness

The ~90-line body is dense instruction with no explanations of concepts Claude already knows: every line is a step, a judgment rule, a concrete example, or output format. It leans on Claude's competence (e.g. "Review a change like the senior developer who will be paged when it breaks") with every token earning its place, matching anchor 5.

5 / 5

Actionability

Guidance is fully executable for an instruction-only skill: concrete steps ("grep every caller", "say which load you assumed"), enumerated finding categories with specific instances (check-then-write races, O(n^2), a query per item), exact output templates ("Verdict: Ship.", "Lean: -<N> lines possible."), and a complete worked example finding containing all four parts with a copy-paste fix. Per the scoring notes, absence of code is not penalized when guidance is this actionable — anchor 5.

5 / 5

Workflow Clarity

The body lays out a clear four-phase sequence (Understand first → Look for → Check before you report → Output) with an explicit validation checkpoint: "Re-read the lines and confirm: the caller exists, the value can really be empty, the code really is unused" and "No case, no finding". This matches anchor 5's explicit validation steps and checklist; the destructive/batch cap does not apply since the skill explicitly changes no code.

5 / 5

Progressive Disclosure

The body is well-organized into four clearly numbered sections with no bundle files and no dead-end references, and all content is core guidance that arguably belongs inline. However, at ~92 lines it exceeds the under-50-line simple-skill exception, and supporting material such as the worked example finding or the category definitions could live in a one-level-deep reference file — anchor 4 rather than 5.

4 / 5

Total

19

/

20

Passed

Description

66%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 specific, well-scoped description that clearly conveys what the skill does and in what output shape, written in appropriate third-person voice without fluff. Its main weakness is the complete absence of 'when to use' trigger guidance, which caps completeness and weakens trigger-term coverage for natural invocation phrases like 'code review' or 'PR'.

Suggestions

Add an explicit 'when' clause, e.g. "Use when the user asks to review, critique, or find problems in a diff, PR, branch, or uncommitted changes."

Include common invocation synonyms in the description ("code review", "PR", "pull request", "critique this change") so users' natural phrasings match the trigger.

State the review targets more explicitly as triggers (uncommitted changes, staged changes, branches, PR links) since those inputs are already enumerated in the body.

DimensionReasoningScore

Specificity

The description enumerates concrete review areas ("bugs, security, real load, missing tests, speed, and what to delete") and specifies the finding format ("Each finding says what goes wrong and how to fix it"), matching anchor 4's several specific actions with minor gaps. It is not a 5 because the only action verb is 'review' — the enumerated items are focus areas rather than a comprehensive list of concrete actions.

4 / 5

Completeness

The 'what' is clear and concrete (quality review of a diff across six named dimensions with a defined finding format), but there is no 'Use when...' clause or equivalent explicit trigger guidance; the 'when' is only weakly implied by 'of a diff'. Per the judging guideline, a missing 'Use when' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Terms like "review", "diff", "bugs", "security", "missing tests", and "speed" are natural user phrasings for requesting this skill, giving good keyword coverage (anchor 4). Common variations such as "code review", "PR", or "pull request" are absent, keeping it below anchor 5's comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

"Quality review of a diff" plus the distinctive lean/delete emphasis ("what to delete") carves a mostly distinct niche with minimal trigger confusion, matching anchor 4. It is not a 5 because it overlaps with generic code-review skills that would trigger on the same 'review my diff' phrasing.

4 / 5

Total

15

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

DietrichGebert/ponytail

Path

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