CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ponytail-help

Quick reference for ponytail's modes, skills, and commands. One-shot display.

65

Quality

82%

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

The canonical home for this skill is ponytail-help 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 an exemplary one-shot reference card: dense, well-sectioned, fully executable, and free of padding or nested references. Its single display action is stated unambiguously with explicit side-effect constraints, and all commands and configuration snippets are copy-paste ready. No material weaknesses were found.

DimensionReasoningScore

Conciseness

The body is lean throughout: dense tables for levels and skills ("| **Lite** | `/ponytail lite` | Build what was asked, name the smaller option in one line. |"), terse declaratives ("Level sticks until changed or session end."), and no explanation of concepts Claude already knows. Every token earns its place, matching anchor 5 rather than anchor 4 (which presumes over-explanation to trim).

5 / 5

Actionability

Guidance is copy-paste ready: exact slash commands per host, `export PONYTAIL_DEFAULT_MODE=ultra`, a config JSON example with both Unix and Windows paths, and an explicit resolution order ("env var > config file > `full`"). This matches anchor 5 (fully executable commands covering the common cases).

5 / 5

Workflow Clarity

This is a simple single-purpose skill and its single action is unambiguous, including explicit negative constraints: "Display this reference card when invoked. One-shot, do NOT change mode, write flag files, or persist anything." Per the scoring notes, a simple skill with an unambiguous single action scores 5; no destructive or batch operations are involved, so no cap applies.

5 / 5

Progressive Disclosure

The card is self-contained with well-organized sections (Levels, Skills, Deactivate, Band, Configure Default Mode, Update, More) and a single clearly-signaled one-level-deep external pointer (the homepage link under "More"). There is no nested reference chain and no content that belongs in a separate file, matching anchor 5; no bundle files exist to restructure.

5 / 5

Total

20

/

20

Passed

Description

57%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 firmly anchored to a distinctive niche, giving it excellent conflict resistance, but it has no explicit 'when to use' trigger clause and misses the natural trigger terms (especially "help") users would most likely say. It communicates the 'what' adequately but would be substantially stronger with a Use-when clause and a fuller set of natural keywords.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks for ponytail help, usage, modes, or available commands." — this would lift completeness from 3 toward 4-5.

Include natural synonyms users would say such as "help", "usage", "cheat sheet", and "reference card" alongside the current domain keywords to improve trigger term coverage.

Optionally name one or two concrete display behaviors (e.g. "shows the level table, skill triggers, and config options") to push specificity past anchor 3.

DimensionReasoningScore

Specificity

"Quick reference for ponytail's modes, skills, and commands" names the domain and enumerates its content categories, and "One-shot display" is one concrete action — matching anchor 3 (domain plus 1-2 concrete actions, not comprehensive). It is more informative than anchor 2's bare "Processes PDF files" but lists far fewer concrete actions than anchor 4.

3 / 5

Completeness

The 'what' is clear (a one-shot reference card covering modes, skills, and commands), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which per the judging guidelines caps completeness at 3. This exactly fits anchor 3: clear 'what' with 'when' missing or only weakly implied.

3 / 5

Trigger Term Quality

The description contains relevant domain keywords ("ponytail", "modes", "skills", "commands") but omits the most natural phrases a user would say, such as "help", "usage", or "cheat sheet". This matches anchor 3 (some relevant keywords, missing common variations or synonyms) rather than anchor 4's good-coverage-with-minor-gaps.

3 / 5

Distinctiveness Conflict Risk

The description is anchored entirely on "ponytail", a unique proper noun with a clear niche, so no other skill would plausibly trigger for this query. This matches anchor 5 (clear niche with distinct triggers, minimal conflict risk) rather than anchor 4, which presumes minor overlap with closely related skills.

5 / 5

Total

14

/

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