omc-setup
Setup and configure oh-my-claudecode (the ONLY command you need to learn)
62
53%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Critical
Do not install without reviewing
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/omc-setup/SKILL.mdQuality
Discovery
22%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This description is too vague and incomplete to effectively guide skill selection. It fails to explain what oh-my-claudecode actually is or does, provides no explicit trigger conditions, and the parenthetical marketing phrase ('the ONLY command you need to learn') adds no functional value for skill matching.
Suggestions
Add a 'Use when...' clause specifying trigger conditions like 'Use when the user wants to install, configure, or troubleshoot oh-my-claudecode, or mentions shell customization for Claude Code'
Explain what oh-my-claudecode is and list specific capabilities (e.g., 'Installs and configures oh-my-claudecode shell integration, manages themes, sets up aliases and plugins')
Remove the marketing parenthetical and replace with natural trigger terms users might say like 'install', 'shell setup', 'terminal customization', 'omc'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague language ('Setup and configure') without listing concrete actions. It doesn't explain what oh-my-claudecode is or what specific capabilities it provides. | 1 / 3 |
Completeness | Only partially addresses 'what' (setup/configure) and completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | Contains the specific term 'oh-my-claudecode' which users would say, but lacks common variations or related natural keywords like 'install', 'initialization', 'shell', or 'zsh'. | 2 / 3 |
Distinctiveness Conflict Risk | The specific product name 'oh-my-claudecode' provides some distinctiveness, but 'setup and configure' is generic enough to potentially conflict with other installation/configuration skills. | 2 / 3 |
Total | 6 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured setup skill with excellent workflow clarity and progressive disclosure. The phased approach with resume detection and graceful interrupt handling demonstrates thoughtful design. Minor verbosity in help text duplication and repeated flag explanations slightly impacts token efficiency.
Suggestions
Remove the 'Keeping Up to Date' section as it duplicates information already in the help text and flag parsing sections
Consider moving the full help text to a separate reference file since it's displayed conditionally and takes significant space
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is reasonably efficient but includes some redundancy - the help text duplicates information explained elsewhere, and the 'Keeping Up to Date' section repeats flag explanations already covered. Some sections could be tightened. | 2 / 3 |
Actionability | Provides concrete, executable bash commands and clear script paths. The workflow is copy-paste ready with specific file paths, environment variables, and exact commands to run. | 3 / 3 |
Workflow Clarity | Excellent multi-step workflow with clear sequencing: flag parsing → pre-check → resume detection → phased execution. Includes graceful interrupt handling and explicit checkpoints between phases with progress saving. | 3 / 3 |
Progressive Disclosure | Well-structured with clear overview and one-level-deep references to phase files (01-install-claude-md.md, 02-configure.md, etc.). Content is appropriately split between this overview and detailed phase instructions. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
- Repository
- Yeachan-Heo/oh-my-claudecode
- Commit
48ffaac
- 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.