CtrlK
BlogDocsLog inGet started
Tessl Logo

ponytail-audit

Audit the whole repo for over-engineering. A ranked list of what to delete, simplify, or replace with stdlib or native features.

53

Quality

60%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.openclaw/skills/ponytail-audit/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

87%

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

This is a well-crafted, concise skill that efficiently communicates a repo-wide audit process. Its strengths are extreme token efficiency, a clear tag taxonomy, and a precise output format. The only minor weakness is that the workflow could be slightly more explicit about scan order and ranking criteria, though for a non-destructive, one-shot audit this is a minor concern.

DimensionReasoningScore

Conciseness

Extremely lean and efficient. Every line serves a purpose—no explanations of what over-engineering is, no preamble about why simplification matters. Assumes Claude understands the concepts and just needs the operational spec.

3 / 3

Actionability

Provides concrete tag taxonomy with clear definitions, a specific hunt list of what to look for, an exact output format with template, and clear boundary conditions. The output format is copy-paste ready and unambiguous.

3 / 3

Workflow Clarity

The workflow is implicit: scan → tag → rank → output summary. For a single-pass, non-destructive audit that 'lists findings, applies nothing,' this is mostly sufficient, but the sequencing (how to scan, what order to check things) is not explicitly stated. The ranking criterion ('biggest cut first') could be more precise.

2 / 3

Progressive Disclosure

For a simple, single-purpose skill under 50 lines with no need for external references, the content is well-organized into clear sections (Tags, Hunt, Output, Boundaries). No external files are needed and none are unnecessarily referenced.

3 / 3

Total

11

/

12

Passed

Description

32%

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 communicates a clear purpose—auditing repos for over-engineering and producing actionable recommendations—but lacks an explicit 'Use when...' clause, which is a significant gap for skill selection. It also misses common user trigger terms like 'too complex', 'technical debt', or 'refactor' that would help Claude match this skill to user requests.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks to simplify code, reduce complexity, find unnecessary abstractions, or audit for over-engineering.'

Include more natural trigger terms users would say, such as 'too complex', 'technical debt', 'unnecessary dependencies', 'dead code', 'refactor', or 'bloated'.

List more specific concrete actions, e.g., 'Identifies unnecessary abstractions, unused dependencies, redundant wrappers, and code that reimplements standard library functionality.'

DimensionReasoningScore

Specificity

Names the domain (repo auditing for over-engineering) and some actions (delete, simplify, replace with stdlib/native features), but doesn't list comprehensive concrete actions like identifying specific patterns, generating reports, or analyzing dependency trees.

2 / 3

Completeness

Describes what it does (audit for over-engineering, produce ranked list) but has no explicit 'Use when...' clause or equivalent trigger guidance, which per the rubric should cap completeness at 2, and the 'when' is entirely missing, not just implied, warranting a 1.

1 / 3

Trigger Term Quality

Includes some relevant terms like 'over-engineering', 'simplify', 'stdlib', 'native features', and 'repo', but misses common user phrasings like 'too complex', 'unnecessary abstractions', 'dead code', 'refactor', 'complexity', or 'technical debt'.

2 / 3

Distinctiveness Conflict Risk

The focus on over-engineering and simplification is somewhat distinctive, but could overlap with general code review, refactoring, or code quality audit skills since the boundaries aren't clearly drawn.

2 / 3

Total

7

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

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.