Content
85%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with executable commands, clear workflows with validation checkpoints, and clean progressive disclosure to verified reference files. The main weakness is repetitive restatement of the bulk/stream guidance across multiple sections.
Suggestions
Consolidate the stream-vs-search and `--limit` guidance into a single 'Bulk retrieval' section and remove the duplicate restatements in Available Tools and Common Mistakes to improve token efficiency.
Reduce repetition of the 'prefer stream/sparql for bulk data' rule, which appears in Bulk Retrieval Priorities, the IMPORTANT callout, and Common Mistakes.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and assumes Claude's competence, but the stream/`--limit` limitation and 'prefer stream/sparql for bulk' guidance are restated across Available Tools, Bulk Retrieval Priorities, and Common Mistakes, which could be tightened into a single source. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready commands (e.g., `uv run scripts/uniprot_tools.py count "taxonomy_id:9606"`) and concrete SPARQL query patterns for each mode. | 3 / 3 |
Workflow Clarity | Workflows are clearly sequenced with checkbox checklists (Protein Research Workflow), numbered pivot strategies for search misses, and explicit validation checkpoints ('ALWAYS perform a `count` before running a `search`', 'use `--limit 5` to verify'). | 3 / 3 |
Progressive Disclosure | SKILL.md serves as a clear overview with well-signaled one-level-deep references to real bundle files (references/sparql_examples.md, references/search_query_fields.md, references/id_mapping_documentation.md), keeping detailed reference material appropriately split out. | 3 / 3 |
Total | 11 / 12 Passed |