CtrlK
BlogDocsLog inGet started
Tessl Logo

ponytail-review

Review a diff for over-engineering. Finds what to delete: reinvented stdlib, needless deps, speculative abstractions. One line per finding.

68

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a model of lean, actionable instruction: a precise format, defined tags, concrete examples, and clear boundaries with no wasted tokens. It fully leverages the simple-skill and instruction-only carve-outs to score top marks across all dimensions.

DimensionReasoningScore

Conciseness

The body is lean (~45 lines) with no padding or explanations of concepts Claude already knows; every line (format spec, tags, examples, boundaries) earns its place. Not below 3 because there is no verbosity or unnecessary context.

3 / 3

Actionability

Provides a concrete output format ("L<line>: <tag> <what>. <replacement>."), five defined tags with replacement guidance, and five copy-pattern examples. Per the code-vs-instruction note, absence of executable code is not penalized for an instruction-only skill with this concrete, specific guidance.

3 / 3

Workflow Clarity

A simple single-task skill (review → one line per finding → end with "net: -<N> lines possible" or "Lean already. Ship.") with an unambiguous action and explicit terminal condition. The simple-skills carve-out allows 3 without a multi-step workflow; no destructive/batch validation is needed since it only lists findings.

3 / 3

Progressive Disclosure

Under 50 lines with no need for external references and no bundle files present (references/, scripts/, assets/ absent), yet organized into clear sections (Format, Examples, Scoring, Boundaries). The under-50-lines carve-out permits 3 for well-organized sections with no external references.

3 / 3

Total

12

/

12

Passed

Description

67%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific and occupies a clear niche, but lacks an explicit 'Use when...' trigger and offers limited natural-keyword coverage, which caps completeness and trigger-term quality at 2.

Suggestions

Add an explicit trigger clause, e.g. 'Use when reviewing a diff or PR for over-engineering, unnecessary dependencies, or speculative abstractions.'

Broaden natural keyword coverage with terms users actually say (e.g. 'code review', 'pull request', 'simplify', 'dead code', 'YAGNI').

DimensionReasoningScore

Specificity

Lists multiple concrete actions/targets: "Finds what to delete: reinvented stdlib, needless deps, speculative abstractions" plus "One line per finding" — specific, not vague. Not below 3 since it names several concrete capabilities rather than a single domain.

3 / 3

Completeness

Clearly states what it does ("Review a diff for over-engineering. Finds what to delete...") but has no explicit "Use when..." trigger, so the "when" is only implied. Per the rubric, a missing explicit trigger clause caps completeness at 2.

2 / 3

Trigger Term Quality

Contains natural terms like "diff" and "over-engineering" a user might say, but coverage is narrow with no common variations. Not 3 because it lacks broad natural-term coverage; not 1 because the keywords present are genuinely natural rather than jargon.

2 / 3

Distinctiveness Conflict Risk

The niche is distinct — over-engineering review focused on finding what to cut — with triggers unlikely to fire for unrelated skills. Not 2 because the framing ("over-engineering", "reinvented stdlib", "speculative abstractions") carves a clear, narrow scope.

3 / 3

Total

10

/

12

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.

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