CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ponytail-help

Quick reference for ponytail levels, skills and commands. One-shot display. Use for /ponytail-help, "ponytail help", "how do I use ponytail".

70

Quality

88%

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

92%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 single-file reference card: fully concrete commands, unambiguous one-shot behavior, explicit configuration resolution, and well-organized sections with no padding. The only trimmable content is the fallback instructions for updating Claude Code itself in the Update section.

DimensionReasoningScore

Conciseness

The card is lean — dense tables for levels and skills, terse command references, no concept explanations Claude already knows. The one padded spot is the Update section's fallback: "If /plugin is not recognized, your Claude Code is out of date. Update it (`npm install -g @anthropic-ai/claude-code@latest`, or `brew upgrade claude-code`) and restart" explains general Claude Code update knowledge that could be trimmed or pointed at. That minor over-explanation fits anchor 4 ('Efficient; minor instances of over-explanation') rather than anchor 5.

4 / 5

Actionability

Every section gives concrete, executable guidance: exact slash commands (`/ponytail band on`, `/ponytail off`), an env var (`export PONYTAIL_DEFAULT_MODE=ultra`), a config file with exact paths and a JSON snippet (`~/.config/ponytail/config.json`, Windows `%APPDATA%` variant), update commands (`/plugin marketplace update ponytail`), and per-skill trigger tables. For an instruction-only skill this is copy-paste ready — the top anchor.

5 / 5

Workflow Clarity

This is a simple single-purpose skill and the single action is unambiguous: "Display this reference card when invoked. One-shot, do NOT change mode, write flag files, or persist anything." Sections are clearly organized (Levels, Skills, Deactivate, Band, Configure, Update), the default level and its resolution order ("env var > config file > full") are explicit, and there are no destructive or batch operations that would require validation checkpoints, so the simple-skill exception applies.

5 / 5

Progressive Disclosure

The body is a compact (~68-line) reference card that needs no external bundle files — everything present genuinely belongs inline on a cheat sheet — and it is well organized with clear section headers and tables. The single external pointer ("Full docs + examples: https://github.com/DietrichGebert/ponytail") is clearly signaled and one level deep. No nested or buried references.

5 / 5

Total

19

/

20

Passed

Description

78%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: third-person, concise, with an explicit trigger clause containing concrete natural phrases. Its main weakness is thin capability specificity — it says the card covers "levels, skills and commands" without naming any of them — and a few missing natural trigger variations.

Suggestions

Name 1-2 concrete capabilities in the description, e.g. "Summarizes the three ponytail levels (lite/full/ultra) and lists all six slash commands with their triggers. One-shot display."

Add common trigger variations such as "what does ponytail do", "ponytail modes", or "ponytail commands" to broaden natural keyword coverage.

DimensionReasoningScore

Specificity

"Quick reference for ponytail levels, skills and commands. One-shot display." names the domain and one concrete behavior (a one-shot reference card) but does not list any of the specific capabilities or commands it covers. This matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' — below 4 because no several specific actions are enumerated, above 2 because the language is concrete, not generic.

3 / 5

Completeness

The description answers both questions explicitly: what ("Quick reference for ponytail levels, skills and commands. One-shot display.") and when ("Use for /ponytail-help, \"ponytail help\", \"how do I use ponytail\".") with concrete trigger phrases, matching the top anchor. The explicit 'Use for' clause means the missing-trigger cap of 3 does not apply.

5 / 5

Trigger Term Quality

"Use for /ponytail-help, \"ponytail help\", \"how do I use ponytail\"" includes the exact slash command, a spoken phrase, and a natural question, plus the keywords "levels, skills and commands" in the first sentence. Good keyword coverage with a few natural variations missing (e.g. "what does ponytail do", "ponytail modes"), which fits anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

All triggers ("ponytail help", "how do I use ponytail", "/ponytail-help") are clearly help-oriented and unambiguous in intent. However, the description shares the "ponytail" namespace with five sibling skills (ponytail, ponytail-review, ponytail-audit, ponytail-debt, ponytail-gain), creating minor overlap risk with closely related skills — anchor 4 rather than the clear isolated niche of anchor 5.

4 / 5

Total

16

/

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