Content
43%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.
The content is an auto-generated command catalog: executable in form but padded with redundant echo-only examples and duplicate sections, with no workflow sequencing or validation guidance for destructive operations and no progressive disclosure into reference files.
Suggestions
De-duplicate the repeated context-eng config/show/set/list sections and reconcile the conflicting flag lists for 'context-eng set'.
Replace bare echo examples with realistic invocations showing flags in use, and add a one-line description for every subcommand.
Split the bulky catalog into per-topic reference files (e.g., contexts.md, sessions.md, context-eng.md) and keep SKILL.md as a concise overview with clearly signaled links.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | It avoids explaining concepts Claude already knows, but every 'Example:' block merely echoes the bare command header and several subcommands (context-eng config/show/set/list) are duplicated verbatim, leaving noticeable boilerplate that could be tightened. | 3 / 5 |
Actionability | Commands are technically executable, yet most subcommands carry no description, examples never demonstrate flag usage with real values, and duplicate 'context-eng set' blocks list contradictory flags — concrete but with key details missing. | 3 / 5 |
Workflow Clarity | The body is a flat command catalog with no sequencing, and destructive/batch operations (remove, expire-all, import) lack any validation or verification steps; the rough grouping under parent commands is the only structure present. | 2 / 5 |
Progressive Disclosure | Section headers provide some navigability, but a ~386-line command catalog that clearly belongs in split reference files (contexts.md, sessions.md, context-eng.md) is fully inlined with no external references. | 3 / 5 |
Total | 11 / 20 Passed |