Content
80%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 well-structured, highly actionable skill body with excellent progressive disclosure into twelve verified reference files. The main weakness is missing validation/verification checkpoints in batch and multi-signal processing workflows.
Suggestions
Add explicit validation/verification steps to batch workflows (e.g., after nk.bio_process, check signal quality flags or assert expected channel presence before nk.bio_analyze) to lift workflow_clarity above the cap.
De-duplicate the HRV and bio_process code blocks that appear in both 'Core Capabilities' and 'Common Workflows', or cross-reference one from the other, to tighten conciseness.
Convert the 'Analysis Modes' section from an assertion into an instruction (how to force or detect event-related vs interval-related mode) so the workflow is actionable rather than descriptive.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely code-forward with no padding of concepts Claude already knows, but HRV and bio_process examples recur across both 'Core Capabilities' and 'Common Workflows', and the 12-item References section restates the inline reference pointers, leaving minor trim opportunities. | 4 / 5 |
Actionability | Every section provides copy-paste-ready, executable Python with realistic sampling rates and parameters, and the Quick Start covers loading example data through analysis end-to-end. | 5 / 5 |
Workflow Clarity | Processing sequences are shown (e.g., 'cleaning -> R-peak detection -> delineation -> quality assessment') but there are no validation or verification checkpoints for batch operations like bio_process, and the analysis-mode auto-selection is asserted rather than instructed, leaving checkpoint gaps. | 3 / 5 |
Progressive Disclosure | The SKILL.md is a concise overview that signals twelve real one-level-deep reference files (e.g., 'See references/ecg_cardiac.md'), each verified to exist and self-contained with no nested pointer chains, making navigation easy. | 5 / 5 |
Total | 17 / 20 Passed |