Content
96%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 a dense, highly operational guide: exact tool invocations with JSON arguments, a sequenced workflow with retry and error-recovery loops, and explicit safety boundaries. Its only structural weakness is that all operational detail is inlined in a single file with no progressive-disclosure layer for the longer reference material.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body contains zero explanations of concepts Claude already knows; every sentence carries tool-specific operational detail (e.g., "the `<id>` is lower-cased with every run of non-alphanumerics collapsed to `_`"). Lean and efficient throughout, matching the every-token-earns-its-place anchor rather than the minor-trimming anchor at 4. | 5 / 5 |
Actionability | Fully actionable with exact tool names and argument objects: `autorag.search` with `{"query": "...", "topK": 8}`, `autorag.refresh` with `{"methods": ["parsed", "minsync"]}` and `{"force": true}`, plus named result-envelope fields ("`number`, `source`, `method`, `score`, `metadata`, and `content`"). As an instruction-only skill, the guidance is copy-paste-ready equivalent. | 5 / 5 |
Workflow Clarity | A clear 6-step sequence with feedback loops ("Search with 2-3 differently worded queries when the first results do not contain the answer") and a dedicated error-recovery section covering `index-not-ready`, `stale: true`, `unsearched`, and `datasource-*` diagnostics. The destructive/batch cap does not apply: refresh "writes only AutoRAG's own index directories" and duplicates is read-only with "never move or delete files on your own". | 5 / 5 |
Progressive Disclosure | Good structure with clear sections (Workflow, Reading the result envelope, Refresh and duplicates, Safety) and a clearly signaled pointer to the `setup` skill. Not 5 because at ~105 lines — above the under-50-line simple-skill exception — with no bundle files, sections like the envelope diagnostics and the convert/duplicates detail could arguably be split into reference files. | 4 / 5 |
Total | 19 / 20 Passed |