Content
50%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 well-organized but auto-generated command catalog that is mostly lean yet padded with redundant bare-command examples and duplicate subcommand sections. It is actionable at the command level but lacks flag explanations, subcommand descriptions, and validation guidance for destructive operations, and it inlines ~390 lines of reference material that should be split into a separate file.
Suggestions
Deduplicate the repeated 'context-eng config/show/set/list' sections and either remove the bare-command 'Example' blocks or replace them with realistic invocations showing actual flag values.
Add one-line descriptions for every subcommand (especially caveman, rtk, filters, combos, test, get, assignments) and brief explanations of each flag's accepted values and purpose.
Add validation/verification guidance for destructive and batch operations (remove, expire, expire-all), and move the full command reference into a references/ file so SKILL.md stays an overview with one-level-deep navigation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean command reference with no concept-explanation fluff, but it repeats bare-command 'Example' blocks that add nothing beyond the heading and contains duplicate sections (e.g. 'context-eng config', 'show', 'set', and 'list' each appear twice), so 'every token earns its place' is not met — matching 'Mostly efficient but... could be tightened'. Not 3 due to the wasted duplicate and redundant-example tokens; not 1 because it avoids explaining concepts Claude already knows. | 2 / 3 |
Actionability | Commands like 'omniroute context-eng analytics' are runnable, but flags are listed with no meaning (e.g. '--aggressiveness <n>', '--max-shrink-pct <n>', '--preserve-tags <list>') and examples show bare commands with no real values, while many context-eng subcommands (caveman, rtk, filters, combos, test) have no description — matching 'Some concrete guidance but incomplete... missing key details'. Not 3 because examples are not copy-paste ready and flags are unexplained; not 1 because the commands themselves are concrete and executable. | 2 / 3 |
Workflow Clarity | There is no multi-step workflow sequence, and destructive/batch operations ('context-eng remove <id>', 'contexts remove <name>', 'sessions expire <sessionId>', 'sessions expire-all') carry no validation or verification guidance, so per the guideline workflow clarity is capped at 2 — matching 'sequence present but checkpoints missing or implicit' at the organized-catalog level. Not 3 because no validation/feedback loops exist for the risky operations; not 1 because the catalog is organized into clear command groups. | 2 / 3 |
Progressive Disclosure | No bundle files (references/scripts/assets) exist; the entire ~390-line command reference lives inline in SKILL.md, matching the anchor 'content that should be separate is inline' (the '[200 lines of API reference that could be in a separate file]' example). Not 3 because it is far over 50 lines with no external reference file and no signaled one-level-deep navigation; not 1 because sections are well-organized by top-level command rather than a monolithic unstructured wall. | 2 / 3 |
Total | 8 / 12 Passed |