Content
67%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 delivers a well-sequenced, highly actionable multi-source research workflow with graceful degradation at every step and a properly separated domain reference file. Its main weaknesses are redundant documentation of the sources directive and missing error-recovery feedback loops in the workflow.
Suggestions
Merge the Overrides block and the Source Selection examples into a single `— sources:` section to eliminate the duplicated directive documentation and save tokens.
Add a short failure path for the download and research-wiki steps (e.g., what to do when a PDF fails the >10 KB check or add_edge errors), giving the workflow explicit error-recovery feedback loops.
Move the 25-line ARIS_INFRA discovery script and the arXiv/S2 de-duplication rules into a reference file, keeping SKILL.md as a leaner overview with one-level-deep pointers.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The `— sources:` directive is documented twice (the Overrides block and again with 8 examples under Source Selection), and the 25-line ARIS_INFRA discovery script carries heavy commentary — content that could be tightened. It avoids anchor 2 because there is no explanation of concepts Claude already knows; the core content is dense and mission-driven. | 3 / 5 |
Actionability | Provides concrete Glob patterns, executable bash with specific flags (`--max 10`, `--fields-of-study "Computer Science,Engineering"`, `--publication-types`), exact research_wiki.py commands, and an output table schema. Minor gap: the `SCRIPT=""` fallback would make `python3 "" search ...` error out before the documented WebSearch fallback; MCP tool-name flexibility is explicitly justified. | 4 / 5 |
Workflow Clarity | Steps 0a–6 are clearly sequenced with explicit skip conditions at every stage ("Skip this step entirely if... MCP is not configured") and some verification for the batch download ("> 10 KB", 1-second rate limiting, skip papers already in the local library). Not anchor 5 because there are no error-recovery feedback loops (e.g., what to do when add_edge or a download fails). | 4 / 5 |
Progressive Disclosure | Clear section structure with a well-signaled, one-level-deep reference (references/communications-lit-review.md, verified to exist in the bundle). Minor gaps: the detailed arXiv/S2 de-duplication rules and the long infra-locating script are inlined in SKILL.md rather than split out, keeping it short of anchor 5. | 4 / 5 |
Total | 15 / 20 Passed |