Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, highly actionable skill body with excellent progressive disclosure and copy-paste-ready code. The main gaps are mild verbosity/redundancy between the inline workflow and the bundled references, and only implicit validation feedback loops in the multi-step pipeline.
Suggestions
Tighten the inline 8-step workflow by summarizing steps that are fully covered in references/standard_workflow.md and the bundled scripts, keeping only the quick-start essentials and pointers, to reduce overlap and token cost (addresses conciseness).
Add explicit validation checkpoints and a feedback loop in the pipeline section — e.g. 'after preprocessing, verify bad-channel count; after sorting, check unit count vs. expected; if drift > 10 um, re-run correct_motion and re-sort' — to lift workflow_clarity to a 3.
Mark which steps the bundled neuropixels_pipeline.py performs automatically versus which require interactive inspection, so Claude knows where human-in-the-loop validation is expected.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely actionable code and domain-specific API detail Claude does not already know (exact function names, presets, the isi_violations_ratio column), but it runs ~400 lines and the 8-step inline workflow overlaps content already in references/standard_workflow.md and the bundled scripts, so it could be tightened; not level 3 because not 'every token earns its place', not level 1 because it is not padded with general concepts Claude knows. | 2 / 3 |
Actionability | Fully executable, copy-paste-ready code throughout (e.g. si.read_spikeglx(...), si.correct_motion(preset=...), the pipeline command 'python scripts/neuropixels_pipeline.py ... /path/ output/ --sorter kilosort4 --curation allen') with specific runnable scripts, matching the level-3 anchor. | 3 / 3 |
Workflow Clarity | A clear 8-step sequence (load -> preprocess -> drift -> sort -> postprocess -> metrics -> curation -> export) with some validation gates ('Always inspect drift before sorting', detect_bad_channels, trust_model warnings, review uncertain units) is present, but explicit error-recovery feedback loops (validate -> fix -> retry) and hard checkpoints are only implicit, so it sits at level 2 rather than 3. | 2 / 3 |
Progressive Disclosure | SKILL.md is a concise overview with a well-signaled one-level-deep reference table (10 reference files, all verified present as real files in references/), documented scripts/ and assets/, and appropriately split detail; matches the level-3 anchor rather than the inline-bloated level 2. | 3 / 3 |
Total | 10 / 12 Passed |