Content
73%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 well-structured, highly actionable ingest workflow with explicit guards, validation, fallbacks, and a checklist, and it makes good one-level-deep use of three real reference files. Its main weakness is conciseness — the length and several verbose procedural sections could be trimmed without losing clarity.
Suggestions
Tighten verbose sections — the _raw/ move-safety/source-inheritance rules and the academic-paper PyMuPDF extraction recipe each run long and could be condensed or moved to a reference file to improve token efficiency.
Consolidate the repeated GUARD-pattern framing across optional steps into a single shared convention note so each step can drop the boilerplate.
Consider extracting the academic-papers extraction branch (Step 1) into its own reference file alongside url-sources.md and pageindex.md, since it is already a large specialized procedure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and assumes Claude's competence (no explaining what PDF/CSV/markdown are), but the ~540-line body contains padded spots — repeated GUARD framing, verbose _raw/ move-safety and source-inheritance rules, and detailed academic-paper extraction mechanics — that could be tightened, matching the mostly-efficient-but-could-be-tighter anchor. | 3 / 5 |
Actionability | Provides concrete executable bash commands (cache-check, ast-extract, batch-plan), real JSON schemas, frontmatter templates, and platform-specific fallbacks (sha256sum/shasum); minor gaps come from offloading several definitions (config resolution, templates, confidence formula, typed relationships) to an external llm-wiki/SKILL.md file. | 4 / 5 |
Workflow Clarity | Clear Steps 0–8 sequence with explicit GUARDs gating optional steps, validation/feedback loops (cache-check skip logic, PageIndex and QMD fallbacks, batch subagent dispatch), explicit move-safety rules for the batch _raw/ operation, and a final Quality Checklist — matching the explicit-validation-and-feedback-loops anchor. | 5 / 5 |
Progressive Disclosure | Points to three real one-level-deep reference files (url-sources.md, pageindex.md, ingest-prompts.md), all present and clearly signaled with 'Read X and follow it'; minor gaps because sizable inlined material (academic-paper extraction, AST-output handling) could arguably live in its own reference file. | 4 / 5 |
Total | 16 / 20 Passed |