CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ponytail-audit

Quality audit of a whole repo: bugs, security holes, what breaks under real load, risky code without tests, slow paths, and what to delete, merge or split. Ranked, each finding explained in plain English. One-shot report, changes nothing. Use for "audit this codebase", "review the whole repo", "find bloat", "what can I delete", /ponytail-audit.

77

Quality

97%

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

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 exemplary instruction-only skill body: a tightly sequenced audit workflow with concrete look-for lists, hard verification rules before reporting, and a fully specified output format demonstrated by a worked example. The only structural note is that it is a self-contained ~93-line process spec with no bundle files, which is fine but sits just outside the simple-skill case for progressive disclosure.

DimensionReasoningScore

Conciseness

The body is lean throughout — short sentences, no explanations of concepts Claude already knows, and it assumes competence (e.g., it names "check-then-write races" and "O(n^2) on big input" as things to look for without teaching them). The one worked example (the billing/close_day.py finding) earns its tokens by demonstrating the required output format; this fits the 'every token earns its place' anchor rather than the 'minor instances of over-explanation' anchor below.

5 / 5

Actionability

For an instruction-only skill the guidance is fully concrete: exact look-for lists ("injection, weak randomness, secrets in code", "a query per item"), a hard verification rule ("Before calling code unused, grep the whole tree"), a complete four-part finding template with file:line citation format (`billing/close_day.py:L40-52`), an executable one-line fix (`datetime.now(ZoneInfo("Europe/Berlin")).date()`), and exact output strings ("What this repo does:", "Verdict:", "Not checked:"). Per the scoring notes, absence of code blocks is not penalized when the guidance is this actionable; it exceeds the 'mostly executable, minor gaps' anchor.

5 / 5

Workflow Clarity

A clear four-phase sequence (Map first → Look for → Check before you report → Output) with an explicit pre-report validation gate: "Every finding needs a concrete case... No case, no finding" and the grep-before-dead-code check with its remediation (drop the finding if references exist). The destructive/batch cap does not apply because the skill is read-only ("One-shot report, changes no code"); the validation checklist and error-recovery rule (discard unverified findings) match the top anchor.

5 / 5

Progressive Disclosure

The ~93-line body is well organized into four numbered sections and is self-contained with no references, which is appropriate since none are needed; nothing is inlined that clearly belongs in a separate file. It scores 4 rather than 5 because the under-50-line simple-skill exception does not strictly apply and the document is a full process spec rather than an overview with well-signaled references; it is above the 'some structure but could be better organized' anchor.

4 / 5

Total

19

/

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: concrete capability list, explicit natural-language triggers, and a clear what/when pairing, all in third person without padding. The only weakness is slight overlap potential with generic code-review or security-review phrasing.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities — "bugs, security holes, what breaks under real load, risky code without tests, slow paths, and what to delete, merge or split" — plus report shape ("Ranked, each finding explained in plain English. One-shot report, changes nothing"). This matches the anchor for comprehensive, specific action coverage; it is above the 'several specific actions; minor gaps' anchor because the finding categories, ranking, output style, and side-effect contract are all explicit.

5 / 5

Completeness

It explicitly answers 'what' (full-repo quality audit across bugs, security, load, tests, speed, leanness, with ranked plain-English findings) and 'when' ("Use for 'audit this codebase', 'review the whole repo', 'find bloat', 'what can I delete', /ponytail-audit") with concrete trigger phrases. This is the anchor for both what and when clearly and explicitly present; it is not the level below, where 'when' is present but only generically.

5 / 5

Trigger Term Quality

Natural user phrasings are quoted directly: "audit this codebase", "review the whole repo", "find bloat", "what can I delete", plus the slash command /ponytail-audit. Coverage spans synonyms across the skill's intents (audit, review, bloat, deletion), matching the comprehensive-synonyms anchor rather than the 'a few natural terms missing' anchor below it.

5 / 5

Distinctiveness Conflict Risk

The niche (whole-repo, one-shot, change-nothing audit) is clear and triggers like "find bloat" and "what can I delete" are distinct, but "review the whole repo" and the mention of "security holes" carry minor overlap risk with closely related diff-review and security-review skills. It sits between 'clear niche with minimal conflict risk' (5) and this minor-overlap case (4), leaning noticeably above the midpoint but not fully distinct.

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