CtrlK
BlogDocsLog inGet started
Tessl Logo

skill

Manage local skills - list, add, remove, search, edit, setup wizard

33

Quality

30%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/skill/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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

DimensionReasoningScore

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.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

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

Repository
Yeachan-Heo/oh-my-claudecode
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.