Content
56%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 usable, executable API examples backed by real scripts, but is significantly over-padded with templated boilerplate and suffers from structural duplication and inconsistent command paths. Trimming the generic process sections and reconciling the invocation paths would materially improve it.
Suggestions
Remove the generic boilerplate sections ('When to Use', 'Output Contract', 'Validation and Safety Rules', 'Completion Checklist', etc.) that restate process discipline Claude already knows, keeping only the Cellosaurus-specific guidance.
Reconcile the conflicting command paths: pick one canonical invocation path (e.g. `python scripts/client.py ...`) and use it consistently across all examples instead of mixing `20260316/...`, `.trae/skills/...`, and `scripts/...`.
De-duplicate the document skeleton: the file contains two overlapping structures (an upper templated half and a lower '# Cellosaurus API Skill' half) with repeated 'Quick Validation' blocks — merge them into one coherent document.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is padded with generic boilerplate ('When to Use', 'Output Contract', 'Validation and Safety Rules', 'Completion Checklist', etc.) restating process discipline Claude already knows, and it stitches two parallel document skeletons together with duplicated sections and conflicting command paths. | 2 / 5 |
Actionability | Provides real executable commands covering common cases ('client.py info', 'get CVCL_0030', 'search "id:HeLa" --rows 5'), but copy-paste reliability is undermined by inconsistent invocation paths (.trae/skills/... vs scripts/client.py vs 20260316/...). | 4 / 5 |
Workflow Clarity | A clear sequenced 'Recommended Workflow' with validation checkpoints and a completion checklist is present (this is a read-only API skill, so the destructive-cap does not apply), though validation guidance is duplicated ('Quick Validation' appears twice) and templates overlap. | 4 / 5 |
Progressive Disclosure | Sections exist (Capabilities, Usage, References) and referenced bundle files (scripts/client.py, scripts/validate_skill.py) are real and one level deep, but generic boilerplate is inlined in a single file and the stitched-together structure (two skeletons, a mid-document '# Cellosaurus API Skill' heading) makes navigation confusing. | 3 / 5 |
Total | 13 / 20 Passed |