CtrlK
BlogDocsLog inGet started
Tessl Logo

hud

Show or configure the OMX HUD (two-layer statusline)

56

Quality

70%

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/hud/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 body is a tight, executable reference: concrete commands, exact config blocks, precise state-file paths, and a working troubleshooting flow, with no filler. It falls just short of top marks on a few details — unspecified --json output shape, a partial config schema, a version number used as a time-sensitive gate, and inline content that could split into references.

Suggestions

Add a short example of the "omx hud --json" output so the scripting path is fully specified.

Document the full .omx/hud-config.json schema (or state that "preset" is the only key) so configuration changes are unambiguous.

Move the Codex CLI version requirement into a single "Requirements" note to avoid repeating a time-sensitive version number inline.

DimensionReasoningScore

Conciseness

The body is lean and tabular, conveying only OMX-specific facts Claude could not know (state files, presets, config keys) with no padding or generic explanations. Minor trims remain: the version-gated "Codex CLI v0.101.0+" appears twice as a time-sensitive detail outside any deprecation/notes section, and Layer 1 config is explained in both the architecture overview and its own section. Fits anchor 4 ("Efficient; minor instances of over-explanation that could be trimmed"), not anchor 5.

4 / 5

Actionability

Guidance is largely copy-paste ready: exact CLI commands ("omx hud --watch", "omx hud --preset=full"), an exact TOML block for the built-in statusline, the JSON config file, and precise state-file paths. Minor gaps keep it from anchor 5: the "--json" flag's output shape is never shown, and the hud-config.json example reveals only the "preset" key, leaving the rest of the config schema unspecified.

4 / 5

Workflow Clarity

Setup is a clear one-shot flow ("omx setup" configures both layers) with an explicit recovery checkpoint ("if HUD/statusline changes do not appear, restart Codex CLI once"), and troubleshooting is a numbered sequence (check version, run setup, restart). The missing explicit post-change verification step (e.g. confirm the statusline actually renders) places it at anchor 4 rather than 5's "explicit validation steps; feedback loops". No destructive or batch operations, so the workflow cap does not apply.

4 / 5

Progressive Disclosure

With no bundle files, the single-file body is well organized into scannable sections (commands table, presets, layers, config, troubleshooting) that are easy to navigate. The body exceeds 50 lines, so the simple-skill 5 exception does not apply, and the 16-item built-in statusline inventory plus preset layouts could arguably live in a reference file — anchor 4 ("Good structure; most content is appropriately placed; minor organization gaps").

4 / 5

Total

16

/

20

Passed

Description

53%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 names a clear, distinct niche (the OMX HUD statusline) with two concrete actions, but it stops there. It lacks any "Use when..." trigger guidance and misses natural trigger variations like "status line" or "status bar", which limits both completeness and discoverability.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks about the OMX HUD, status line, status bar, or wants to show/change statusline or orchestration state."

Include natural synonyms users would say — "status line" (two words), "status bar", "live status" — alongside "statusline".

Enumerate a few more concrete capabilities (presets, live watch mode, JSON output) to raise specificity from 2 actions to several.

DimensionReasoningScore

Specificity

"Show or configure the OMX HUD (two-layer statusline)" names the domain and exactly two concrete actions (show, configure), but omits capabilities documented in the body such as presets, live watch mode, and JSON output. This matches anchor 3 ("Names domain and 1-2 concrete actions, but not comprehensive"), not anchor 4 which requires several specific actions listed.

3 / 5

Completeness

The "what" is clear (show or configure the OMX HUD statusline), but there is no "Use when..." clause or equivalent trigger guidance — the "when" is entirely absent, not merely weakly implied. Per the judging guideline, a missing 'Use when...' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Relevant keywords "HUD", "statusline", and "OMX" are present, but common natural variations a user would actually say are missing ("status line" as two words, "status bar", "status"). Fits anchor 3 ("Some relevant keywords but missing common variations or synonyms") rather than anchor 4's "good keyword coverage; a few natural terms missing".

3 / 5

Distinctiveness Conflict Risk

"OMX HUD" carves out a clear niche tied to a specific tool, so conflict risk is low, but "statusline" is a generic term that overlaps with generic statusline-configuration skills. Mostly distinct with minor overlap risk matches anchor 4; anchor 5 would require triggers that are unambiguous against all related skills.

4 / 5

Total

13

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

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.