CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

peon-ping-config

Update peon-ping configuration — volume, pack rotation, categories, active pack, and other settings. Use when user wants to change peon-ping settings like volume, enable round-robin, add packs to rotation, toggle sound categories, or adjust any config.

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

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

A highly actionable single-file skill: concrete config schema, executable CLI commands, and a clear edit workflow. The main improvement levers are trimming the example scaffolding and adding a post-edit validation step (JSON validity / config check).

Suggestions

Add a verification step after editing, e.g. validate the JSON or run a 'peon config' check command, to close the workflow validation gap.

Trim the 'User request / Action / Result' scaffolding and ✅/❌ bullets in the examples down to the request and the concrete config change.

DimensionReasoningScore

Conciseness

The settings reference is dense and useful — typed keys, defaults, legacy aliases — with only minor trimmable padding: the 'User request / Action / Result' scaffolding with ✅/❌ bullets in examples and dual CLI+manual paths for the same operations. Fits anchor 4 ('efficient; minor instances of over-explanation'), not the every-token-earns-its-place leanness of 5.

4 / 5

Actionability

Everything is executable: the exact config path '${CLAUDE_CONFIG_DIR:-$HOME/.claude}/hooks/peon-ping/config.json', every key with type/default, copy-paste CLI commands ('peon packs bind <pack> --pattern "*/Frontend/*"', 'peon notifications off'), and complete JSON examples for rotation and path_rules. This matches anchor 5's fully executable, copy-paste-ready coverage of common cases.

5 / 5

Workflow Clarity

'1. Read the config file using the Read tool / 2. Edit the relevant field(s) using the Edit tool / 3. Confirm the change to the user' is a clear, tool-named sequence for a simple task — anchor 4. Not 5 because there is no validation checkpoint (e.g., verify JSON validity after editing), though config edits are not destructive/batch so the 3-cap does not apply.

4 / 5

Progressive Disclosure

The single SKILL.md (~139 lines) is well-sectioned (Config location, Available settings, How to update, Examples, Directory pack bindings, CLI commands) with no nested references. Anchor 4 fits: good structure, but at >50 lines the pack-bindings deep-dive and example gallery could live in one-level-deep reference files, so it falls short of anchor 5's ideal split.

4 / 5

Total

17

/

20

Passed

Description

87%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 voice, concrete capability list, and an explicit 'Use when' clause with natural trigger phrases covering the common configuration requests. Only minor coverage gaps (notifications, pack bindings) keep specificity and trigger quality at 4.

Suggestions

Mention desktop notifications and directory pack bindings in the capability list to raise specificity coverage.

Add natural trigger phrases like 'notification popps' or 'bind a sound pack to a directory' to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

Names the domain and several concrete settings — 'volume, pack rotation, categories, active pack, and other settings' — matching anchor 4's 'several specific actions; minor gaps in coverage'. It is not comprehensive enough for 5 (omits pack bindings, desktop notifications, disabled sounds) but goes well beyond anchor 3's 1-2 actions.

4 / 5

Completeness

Both questions are explicitly answered: 'what' via 'Update peon-ping configuration — volume, pack rotation, categories, active pack, and other settings' and 'when' via 'Use when user wants to change peon-ping settings like...' with concrete trigger phrases — the anchor-5 pattern. Not 4 because the when-clause is explicit and trigger-specific, not merely present.

5 / 5

Trigger Term Quality

'Use when user wants to change peon-ping settings like volume, enable round-robin, add packs to rotation, toggle sound categories, or adjust any config' captures natural user phrasings. A few natural terms are missing (notifications, sound packs, binding packs), fitting anchor 4 rather than the comprehensive synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

Tied to a distinct named tool ('peon-ping') with triggers specific to its settings, giving a clear niche and minimal conflict risk — anchor 5. It is far more distinct than anchor 4's generic file-type overlap examples.

5 / 5

Total

18

/

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

PeonPing/peon-ping

Path

skills/peon-ping-config/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.