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 is well-organized with runnable, copy-paste examples that match the bundled script. Its main weaknesses are a padded Implementation Details section and Key Features entries (expression mapping, hierarchy, species projection) that have no corresponding commands. The reference file also defers entirely to external documentation rather than adding value.
Suggestions
Trim the Implementation Details section: remove statements that restate the examples (stable-ID format, generic API-access description) and the duplicated https://reactome.org/dev link, keeping only non-obvious details like the text/plain newline-separated identifier submission format.
Either provide runnable examples for the claimed expression analysis, hierarchy access, and species projection features, or remove them from Key Features since the bundled script supports only query_content and analyze_identifiers.
Remove the reactome2py dependency (the script uses only requests) and populate references/api_reference.md with concrete endpoint details (e.g., /data/query/{id}, POST /identifiers/ with text/plain) instead of a bare pointer to reactome.org/dev.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient, but the "Implementation Details" section pads with statements Claude can infer: "The skill uses the Reactome REST API... to fetch pathway content" and "Stable IDs: Content retrieval expects Reactome stable identifiers (commonly formatted like R-HSA-xxxxx...)" restate what the examples already show. The https://reactome.org/dev link is also duplicated from references/api_reference.md. Not a 2 because the rest (When to Use, Key Features, Dependencies, examples) is tight and useful. | 3 / 5 |
Actionability | Both example commands ("python scripts/reactome_tool.py query_content --id \"R-HSA-69278\"" and "analyze_identifiers --identifiers \"TP53,BRCA1\"") are copy-paste ready and match the actual script's CLI. Not a 5 because Key Features claims "Expression analysis", "Pathway hierarchy access", and "Species projection" yet provides no commands or steps for any of them. | 4 / 5 |
Workflow Clarity | The install-then-run sequence is clear and both single-step actions are unambiguous (this is a simple, non-destructive skill, so no validation cap applies). Falls short of 5 because there is no guidance on interpreting the JSON output, handling the script's error dictionaries, or what to do after an analysis returns. | 4 / 5 |
Progressive Disclosure | The body is a well-sectioned overview pointing to a real one-level-deep reference ("see `references/api_reference.md`") and a working script (scripts/reactome_tool.py), so navigation is easy. Not a 5 because api_reference.md is content-free (just an external link), so the split adds little, and the reference is mentioned twice redundantly. | 4 / 5 |
Total | 15 / 20 Passed |