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 well-structured, highly actionable skill body: a complete runnable example, a clearly explained processing pattern, and detail correctly pushed to reference files. Weaknesses are minor — slight redundancy across feature lists and one orphaned bundle reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes Claude's competence — no padding explaining what ECG or HRV is, and sections are tight with runnable code. Minor over-explanation exists: the "Key Features" bullet list overlaps with "When to Use" and "Implementation Details", and could be trimmed. Not a 3 because there is no genuinely unnecessary concept explanation. | 4 / 5 |
Actionability | The "Example Usage" section is a complete, copy-paste-ready script covering simulation, ECG processing, HRV, multimodal bio_process/bio_analyze, and event-related epoching; install commands and concrete API calls with parameters (e.g., nk.signal_filter with lowcut/highcut) cover the common cases. This matches the fully-executable anchor. | 5 / 5 |
Workflow Clarity | "Implementation Details" gives a clear typical pattern (process → analyze → hrv), explains event-related vs interval-related mode selection, and sequences the event workflow (events_find → epochs_create → epochs_average). Not a 5 because there are no explicit validation checkpoints (e.g., verifying peak-detection quality before computing HRV); not a 3 because the sequences are well defined and the operations are non-destructive analysis. | 4 / 5 |
Progressive Disclosure | SKILL.md is a proper overview: quick start example inline, bulk detail split into one-level-deep reference files that are listed by path and signaled inline ("see references/signal_processing.md", "see references/complexity.md"). Scored against the actual bundle, one reference file (references/ppg.md) exists but is never listed or referenced in the body — a minor organization gap that keeps this below the clear, fully-signaled anchor. | 4 / 5 |
Total | 17 / 20 Passed |