CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ponytail-debt

Harvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.

64

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./.openclaw/skills/ponytail-debt/SKILL.md

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

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.

The body is exemplary: an executable, verified grep command; a precise output template with a rot-risk flag; a filtering checkpoint against false positives; and explicit read-only boundaries — all in ~35 lean lines with nothing wasted. Nothing meaningful to improve.

DimensionReasoningScore

Conciseness

The body is ~35 lean lines across three tight sections (Scan / Output / Boundaries) with zero padding; the only explanatory prose ("Every deliberate ponytail shortcut is marked with a `shortcut:` comment...") teaches a repo-specific convention Claude cannot know, which earns its tokens. Every line either gives a command, a format, or a boundary; not a 4 because there is no over-explanation to trim.

5 / 5

Actionability

The core command `git grep --no-index --exclude-standard -nE '(#|//|/[*]) ?(shortcut|ponytail):'` was executed in a scratch repo and worked copy-paste ready — it found the marker and skipped gitignored files; the output row template, the `no-trigger` tagging rule, the optional `git blame -L<line>,<line>`, and custom-marker-word handling cover the common cases concretely. Not a 4: no gaps remain — the guidance is fully executable and verified.

5 / 5

Workflow Clarity

This is a simple one-shot, read-only skill ("Reads and reports only, changes nothing"), so the simple-skill exception applies: the single action is unambiguous, sequenced scan → filter ("Skip hits that are not a deferral") → grouped output → rot-risk flag → count summary. The destructive/batch validation cap does not apply because the operation mutates nothing; not a 4: the sequence and its one checkpoint (deferral filtering) leave no gaps for a skill of this scope.

5 / 5

Progressive Disclosure

At under 50 lines with no need for external references, the guideline explicitly permits a 5 on well-organized sections alone — and the three headers (Scan, Output, Boundaries) each hold exactly the content that belongs at that level, with nothing that should be split into bundle files. Not a 4: there are no organization gaps; navigation is trivial.

5 / 5

Total

20

/

20

Passed

Description

53%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.

The description is concise and names a concrete, distinctive capability, but it omits any trigger guidance ('use when') and lacks the natural synonyms (technical debt, TODO markers) users would most likely say when reaching for this skill. It reads well but would benefit from an explicit trigger clause.

Suggestions

Add a 'Use when...' clause, e.g. 'Use when the user asks for a debt report, shortcut audit, or to collect deferred-work markers.'

Include natural synonyms users would say — 'technical debt', 'TODO markers', 'deferred work' — alongside 'shortcut' and 'debt ledger'.

Mention the report shape (per-file rows flagging markers with no upgrade trigger) so the 'what' covers more of the actual capability.

DimensionReasoningScore

Specificity

"Harvest every shortcut: comment into one debt ledger" names a concrete domain and one composite action (collect comments into a ledger) plus "One-shot report", but coverage is not comprehensive — scanning, flagging untriggered markers, and output format are absent. Not a 4: it does not list several specific actions, only one main one; not a 2: the action is concrete, not generic.

3 / 5

Completeness

The 'what' is clear ("Harvest every shortcut: comment into one debt ledger... One-shot report"), but there is no 'Use when...' clause or equivalent trigger guidance, capping completeness at 3 per the judging guidelines. Not a 4: the 'when' is entirely absent, not just implicit; not a 2: the 'what' is specific and well-defined.

3 / 5

Trigger Term Quality

Relevant keywords are present ("shortcut", "debt ledger", "deferrals", "tracked"), but common natural variations users would actually say are missing — "technical debt", "TODO markers", "code debt". Not a 4: keyword coverage has gaps beyond "a few natural terms missing"; not a 2: terms present are domain-specific and relevant rather than generic.

3 / 5

Distinctiveness Conflict Risk

"shortcut: comment" and "debt ledger" carve out a clear niche (a repo-specific marker convention audit) that is unlikely to fire for unrelated skills. Not a 5: the anchor example pairs the niche with explicit 'Use when' trigger phrases, which are absent here; the bare word "shortcut" also carries minor overlap risk with generic TODO/technical-debt skills. Not a 3: the niche is far more specific than "Works with document files"-level overlap.

4 / 5

Total

13

/

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