Content
82%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.
A highly actionable, well-sequenced pipeline guide whose code examples are executable end-to-end and whose detail is appropriately pushed into real one-level-deep reference files. The main weaknesses are mild redundancy (duplicated section/listing content) and missing validation checkpoints after the sorting and export stages.
Suggestions
Merge the 'Bundled Resources' section and 'Detailed Reference Guides' table into a single reference listing, and trim 'Overview'/'When to Use This Skill' to avoid restating the frontmatter description — this would tighten conciseness without losing information.
Add explicit validation checkpoints after risky or long-running stages: e.g., verify the preprocessed channel count after bad-channel removal, confirm the sorter output folder was created before postprocessing, and check that the exported .nwb file loads before declaring the pipeline done.
Document the bundled scripts 'explore_recording.py' and 'neuropixels_pipeline.py' (currently listed in scripts/ but never referenced in SKILL.md), or remove them from the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with pipeline-specific executable code and never explains concepts Claude already knows (no 'what is spike sorting' padding). However, 'Overview' and 'When to Use This Skill' largely restate the frontmatter description, and 'Bundled Resources' plus 'Detailed Reference Guides' list the same reference files twice — minor trimming that keeps it at anchor 4 rather than 5. | 4 / 5 |
Actionability | Nearly everything is copy-paste-ready: 'si.read_spikeglx(\'/path/to/data\', stream_id=\'imec0.ap\')', the full preprocessing chain with parameters, 'si.run_sorter(\'kilosort4\', rec, folder=\'ks4_output\')' plus CPU alternatives, all 'analyzer.compute(...)' extensions with arguments, a thresholded curation query, and CLI invocations for every bundled script. Specific examples cover the common cases end-to-end, matching anchor 5. | 5 / 5 |
Workflow Clarity | The 8-step 'Standard Analysis Workflow' is clearly sequenced and includes an explicit checkpoint — step 2 says 'Always check drift before spike sorting' with a '> 10' micron threshold gating whether correction is applied. It stops short of anchor 5 because later stages lack verification (no check that sorting output exists, no validation that the NWB export loads) and there are no feedback loops for error recovery. | 4 / 5 |
Progressive Disclosure | All 10 referenced reference files exist and reference only external URLs (one level deep), scripts and the asset template are documented with CLI usage, and the SKILL.md works as an overview with quick-start inline. Minor organization gaps hold it at anchor 4: the reference files are listed twice (Bundled Resources section and Detailed Reference Guides table), and bundled scripts 'explore_recording.py' and 'neuropixels_pipeline.py' are never mentioned. | 4 / 5 |
Total | 17 / 20 Passed |