skill

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

Quality

68%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/oh-my-codex/skills/skill/SKILL.md

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable with executable scripts, templates, and clear confirmation-gated workflows, but it is overlong and monolithic. Filler sections, a duplicated section, and inline templates that belong in separate reference files hurt conciseness and progressive disclosure.

Suggestions

Remove the non-actionable filler sections (Benefits of Local Skills, Tips for Users, Future Enhancements) and delete the duplicated "Related Skills" section to cut length.

Move the four skill templates and the long example session into separate reference files under references/, keeping SKILL.md as a concise overview with one-level-deep links.

Trim repeated example-output blocks so each subcommand shows one compact illustration rather than multiple verbose transcripts.

Dimension	Reasoning	Score
Conciseness	The 830-line body is mostly actionable but padded with non-essential sections (Benefits, Tips for Users, Future Enhancements), a duplicated "Related Skills" section, and repeated example output blocks that could be tightened.	2 / 3
Actionability	Provides concrete, executable guidance throughout: real bash scripts for the setup scan, copy-ready YAML/markdown templates, and detailed example transcripts for every subcommand.	3 / 3
Workflow Clarity	Multi-step workflows are clearly numbered with explicit validation/confirmation checkpoints for destructive and batch operations ("Never delete without explicit user confirmation", "Never overwrite without confirmation") plus a dedicated Error Handling section.	3 / 3
Progressive Disclosure	Content is well-sectioned but monolithic at 830 lines with no bundle files; the four templates and example sessions are inlined when they could be split into one-level-deep reference files.	2 / 3
	Total	10 / 12 Passed

Description

60%

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 enumerates concrete capabilities clearly but reads as a command list rather than a triggered skill description. It lacks an explicit "Use when..." clause and relies on generic verbs that limit trigger quality and distinctiveness.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user wants to manage, organize, or search their local skills."

Replace generic command verbs with natural user phrasings (e.g. "find a skill", "create a new skill", "clean up old skills") to improve trigger-term quality.

Tie triggers to the skill-management niche more specifically to reduce overlap with general search/edit skills.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions ("list, add, remove, search, edit, setup wizard"), matching the top anchor for enumerating distinct capabilities.	3 / 3
Completeness	It clearly states what the skill does ("Manage local skills...") but has no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 2 per the rubric.	2 / 3
Trigger Term Quality	The verbs (list, add, remove, search, edit) are relevant but generic command words rather than the natural phrases and common variations a user would say; coverage is partial.	2 / 3
Distinctiveness Conflict Risk	"local skills" gives it a niche, but the generic verbs (search, edit, list) could still overlap with other skills, so it is not a fully distinct, conflict-free trigger set.	2 / 3
	Total	9 / 12 Passed

Validation

87%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (837 lines); consider splitting into references/ and linking	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	14 / 16 Passed

Repository: Yeachan-Heo/oh-my-codex
Path: plugins/oh-my-codex/skills/skill/SKILL.md
Commit: 435d4a9

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.