Manage local skills - list, add, remove, search, edit, setup wizard
33
30%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/skill/SKILL.mdQuality
Discovery
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 is a concise but overly terse summary that lists actions without sufficient context. It lacks a 'Use when...' clause, which is critical for Claude to know when to select this skill. The trigger terms are reasonable but incomplete, and the description would benefit from more explicit guidance on triggering scenarios.
Suggestions
Add an explicit 'Use when...' clause, e.g., 'Use when the user wants to manage, install, create, list, or configure local skills, or mentions SKILL.md files.'
Expand the action descriptions slightly for clarity, e.g., 'List available local skills, add new skills from templates, remove unused skills, search skill registry, edit skill definitions, and run the skill setup wizard.'
Include natural user trigger terms like 'install skill', 'create skill', 'skill configuration', 'SKILL.md', or 'skill registry' to improve matching.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists several actions (list, add, remove, search, edit, setup wizard) but they are terse and lack detail about what is being managed. 'Manage local skills' names the domain but the actions are just single words without elaboration. | 2 / 3 |
Completeness | Describes what it does (manage local skills with listed actions) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per rubric guidelines, missing 'Use when' caps completeness at 2, and the 'what' is also quite thin, warranting a 1. | 1 / 3 |
Trigger Term Quality | Includes some relevant terms like 'skills', 'add', 'remove', 'search', 'edit', and 'setup wizard', but misses natural user phrases like 'install skill', 'create skill', 'skill management', 'configure skills', or 'SKILL.md'. | 2 / 3 |
Distinctiveness Conflict Risk | 'Local skills' is a somewhat specific domain that narrows the scope, but 'manage', 'list', 'add', 'remove', 'search', 'edit' are very generic verbs that could overlap with many management-type skills. The term 'setup wizard' adds some distinctiveness. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
27%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is comprehensive in scope but severely over-engineered for a single SKILL.md file. It covers many subcommands with detailed examples and templates, but the extreme verbosity (duplicate sections, user-facing marketing copy, four full skill templates inline, lengthy bash scripts) wastes token budget. The content would benefit enormously from splitting templates and scripts into separate referenced files and trimming explanatory prose that Claude doesn't need.
Suggestions
Extract the four skill templates (Error Solution, Workflow, Code Pattern, Integration) into a separate TEMPLATES.md file and reference it from the main skill
Remove the 'Benefits of Local Skills', 'Tips for Users', and 'Future Enhancements' sections — these are user-facing content, not actionable instructions for Claude
Remove the duplicate 'Related Skills' section and consolidate redundant content throughout
Add explicit validation checkpoints: validate YAML frontmatter before writing, verify file was created/deleted successfully, and include error recovery steps for file operations
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose at ~500+ lines. Contains extensive template boilerplate, redundant sections (Related Skills listed twice), a 'Future Enhancements' section that adds no actionable value, lengthy bash scripts for scanning that Claude could generate on its own, and explanations of concepts like 'Benefits of Local Skills' and 'Tips for Users' that are user-facing marketing rather than instructions for Claude. The skill quality guidelines section explains what makes a good skill with examples Claude doesn't need spelled out at this length. | 1 / 3 |
Actionability | Provides concrete file paths, directory structures, YAML templates, and bash scripts, which is good. However, much of the content is descriptive rather than executable — the subcommand behaviors are described in prose with example outputs rather than providing precise implementation logic. The bash scripts in /skill setup are executable but the rest relies on Claude interpreting behavioral descriptions. | 2 / 3 |
Workflow Clarity | Multi-step processes like /skill add and /skill setup have numbered steps with clear sequences. However, validation checkpoints are mostly absent — there's no explicit 'validate YAML before writing' step, no error recovery loops for file operations, and the /skill remove command mentions confirmation but doesn't describe what happens if the file deletion fails. The setup wizard steps are sequential but lack feedback loops. | 2 / 3 |
Progressive Disclosure | Everything is crammed into a single monolithic file with no references to external files despite the content being extremely long. The four skill templates alone could be in a separate TEMPLATES.md. The bash scanning scripts could be in a separate file. The skill quality guidelines could be referenced. No bundle files are provided, and the content would greatly benefit from being split across multiple files with clear navigation. | 1 / 3 |
Total | 6 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (848 lines); consider splitting into references/ and linking | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
679b418
Table of Contents
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.