Content
100%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 body is an exemplary lean, single-purpose skill: concrete executable examples on both the MCP and CLI paths, explicit fallback and empty-index failure handling, and no wasted tokens. No changes needed for a skill of this scope.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is 36 lines of pure directive and example content with zero concept explanation — the single prose sentence "Search indexed content without rereading raw sources into conversation context" justifies itself by stating the purpose. Every token earns its place, matching the lean anchor 5; there is no padding to trim for a 4. | 5 / 5 |
Actionability | Both execution paths get concrete, copy-paste-ready examples with realistic values: the MCP call `ctx_search({source: "project:<name>", queries: ["authentication middleware", "token refresh"], limit: 5})` and the CLI `context-mode search "authentication middleware" --source project:<name> --limit 5`. Guidance like "Use short, specific queries of two to four technical terms" is specific and measurable, matching anchor 5 rather than 4 because the common cases are fully covered. | 5 / 5 |
Workflow Clarity | The numbered flow covers the primary path (steps 1–4: prefer MCP, batch queries, scope by source, query style), an explicit fallback (step 5: "If MCP tools are unavailable, fall back to the CLI"), and failure recovery (step 6: empty index → remediation via "/context-mode:ctx-index or context-mode index <path>"). This is a single-action, non-destructive skill where the simple-skill exception applies, and the fallback plus failure handling go beyond the unambiguous-single-action bar. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, self-contained, and needs no external reference files (none exist in the bundle), with clean section organization (title, purpose line, Instructions with embedded examples). Per the rubric guideline, skills under 50 lines with no need for external references score 5 with well-organized sections, which this body satisfies. | 5 / 5 |
Total | 20 / 20 Passed |