CtrlK
BlogDocsLog inGet started
Tessl Logo

omx-setup

Setup and configure oh-my-codex using current CLI behavior

60

Quality

76%

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

Fix and improve this skill with Tessl

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

The canonical home for this skill is omx-setup in Yeachan-Heo/oh-my-codex

SKILL.md
Quality
Evals
Security

Quality

Content

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

The content is a dense, highly actionable instruction card: exact commands, flag semantics, resolution rules, verification steps, troubleshooting, and an explicit exit contract with an error-recovery loop. Its only weakness is occasional over-compression — a few layered run-on sentences and repeated interactive/non-interactive caveats that could be tightened or tabulated.

DimensionReasoningScore

Conciseness

The body is lean and operational with no padding or explanation of concepts Claude already knows ('Do not infer new CLI behavior from this card; the implementation is authoritative'). Minor trimming is possible: the interactive/non-interactive distinction is repeated across sections ('non-interactive runs do not block', 'non-interactive runs preserve it', 'non-interactive runs preserve existing files'), and bullets like the '--merge-agents' selector line pack layered caveats into single run-on sentences.

4 / 5

Actionability

Guidance is fully executable: copy-paste commands ('omx setup --force --verbose', 'omx doctor', 'npm run build' followed by 'node dist/cli/omx.js setup --force --verbose'), exact flag spellings and semantics, and a concrete scope/mode resolution procedure with an explicit discovery path ('${CODEX_HOME:-~/.codex}/plugins/cache/**/.codex-plugin/plugin.json with name: oh-my-codex'). Common cases (installed CLI vs local source, plugin vs legacy) are each covered.

5 / 5

Workflow Clarity

The sequence is clearly organized (resolve scope/mode in numbered steps, run setup, verify, troubleshoot, report) with an explicit validation checkpoint ('Expect doctor evidence for prompts and skills in the selected scope, project-root AGENTS.md, .omx/state, and CLI-first config'). The exit contract provides a feedback loop for error recovery ('on failure preserve the exact command output and rerun the smallest corrective command') and a stop checklist ('Do not claim installation from a dry-run alone'), which satisfies validation requirements for this mutating operation.

5 / 5

Progressive Disclosure

The body is roughly 54 lines, well-sectioned under clear headers, with a single clearly-signaled one-level-deep reference ('Shared safety, lifecycle, hook, team, autonomy, and cancellation rules live in templates/AGENTS.md'). No bundle files exist or are needed, so the well-organized section structure fully meets the short-skill bar.

5 / 5

Total

19

/

20

Passed

Description

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

The description is concise and third-person but undersells a detailed skill: it gives a bare 'what' (setup/configure a named tool) with no 'when' and no concrete actions. It avoids vagueness pitfalls only via the tool name, while missing the trigger guidance and natural keywords that would let a user reliably invoke it.

Suggestions

Add a 'Use when...' clause with explicit triggers, e.g. 'Use when installing or refreshing oh-my-codex (OMX) for a user or project scope, or when the user mentions OMX, omx setup, or setup/doctor failures.'

Replace the generic 'Setup and configure' with the concrete actions from the body, e.g. 'Install or refresh OMX prompts, native agents, skills, and config.toml in user or project scope; scaffold AGENTS.md; verify with omx doctor.'

Include the natural trigger synonyms users would say — 'install', 'initialize', 'refresh', and the 'OMX' abbreviation — not just 'setup' and 'configure'.

DimensionReasoningScore

Specificity

The description names the domain ('oh-my-codex') but the actions are generic: 'Setup and configure' are near-synonymous catch-all verbs with no concrete actions such as installing prompts/agents/skills or merging config.toml. It fits anchor 2 ('Names the domain but actions are minimal or generic'), not anchor 3, which requires 1-2 concrete named actions.

2 / 5

Completeness

The 'what' is stated ('Setup and configure oh-my-codex using current CLI behavior') but the 'when' is entirely absent — there is no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is above anchor 2 because the 'what' is not vague; it clearly identifies the tool and task.

3 / 5

Trigger Term Quality

Some relevant natural terms are present ('Setup', 'configure', 'oh-my-codex') but common variations users would actually say are missing: 'install', 'initialize', 'refresh', and the 'OMX' abbreviation used throughout the body. This matches anchor 3 ('Some relevant keywords but missing common variations or synonyms') rather than 4, since the most likely user phrasing ('install omx') is absent.

3 / 5

Distinctiveness Conflict Risk

Naming the specific tool 'oh-my-codex' gives a clear niche unlikely to trigger unrelated skills, but the generic 'Setup and configure' framing creates minor overlap risk with closely related sibling skills the body itself hints at (doctor, update, agents-init). It fits anchor 4 ('Mostly distinct; minor overlap risk with closely related skills') rather than 5, which requires distinct trigger phrases that are absent.

4 / 5

Total

12

/

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