Content
78%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tight, well-organized reference that respects the token budget completely and needs no bundle files. Its main weakness is that it reads as a settings inventory: it lists what exists (sources, env vars) without explaining how they behave or how to use them, leaving the 'matching' behavior unexplained.
Suggestions
Add 1-2 lines explaining rule matching/selection order (which source wins, how file-specific rules are matched), since both the description and the body's "matching file-specific rules" line currently leave this undefined.
Briefly state what each CODEX_RULES_MODE value does (e.g., 'static = inject at SessionStart only') so the env-var list is directly usable rather than just a name inventory.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~25-line body is lean: every line states plugin-specific facts (injection events, source globs, env var names and value formats) with zero padding and no explanation of concepts Claude already knows. Matches anchor 5 ('Lean and efficient... every token earns its place'); nothing to trim. | 5 / 5 |
Actionability | Concrete details are present (exact env vars like "CODEX_RULES_MODE=both|static|dynamic|off" and exact file globs like ".omo/rules/**/*.md"), but the body is descriptive rather than instructive — it never shows how to configure a source, disable injection, or what the modes do, and rule "matching" (promised in the description) is never explained. Matches anchor 3 ('Some concrete guidance but incomplete; missing key details'); not 4 because no usage example or semantic explanation accompanies the raw settings list. | 3 / 5 |
Workflow Clarity | As a simple single-purpose reference skill with no multi-step process or destructive operations, the content is organized into clearly labeled fact groups (injection behavior, sources, env knobs, legacy fallback). Scored 4 rather than 5 because the matching/selection behavior is named in the description but absent from the body, leaving one ambiguity about how rules are chosen. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with no need for external references, and the content is well organized into labeled lists ("Supported project sources", "Supported environment knobs") with no bundle files to reference. Per the simple-skill guideline this matches anchor 5; not 4 because there is no content that should be split out — everything belongs at this level. | 5 / 5 |
Total | 17 / 20 Passed |