Content
76%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 is actionable and well-structured, with a complete runnable example and clear pointers to per-modality reference files. Its main gaps are the total absence of validation/verification checkpoints in the processing workflow and a couple of minor navigation inconsistencies.
Suggestions
Add validation/verification checkpoints to the pipeline pattern (e.g., inspect ecg_info['ECG_R_Peaks'] to confirm peak detection, or run a signal-quality check before computing HRV) and an error-recovery note for failed analyses.
Include references/ppg.md in the reference docs list on line 19, since PPG is listed under Key Features, and format the reference paths as markdown links for easier navigation.
Tighten the 'Analysis mode selection' and 'HRV domains and inputs' prose to the essential neurokit2-specific behavior to improve token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and free of generic editorial fluff, leaning on a runnable example plus neurokit2-specific patterns; minor prose in the "Analysis mode selection" and "HRV domains" sections could be trimmed without losing value, placing it just above the midpoint. | 4 / 5 |
Actionability | Provides a fully executable, copy-paste-ready example that simulates signals, runs ecg_process/hrv, bio_process/bio_analyze, and event-related epoching, plus concrete smaller snippets for filtering and complexity that cover the common cases. | 5 / 5 |
Workflow Clarity | A clear numbered sequence and pipeline pattern (process -> analyze -> hrv) are present, but there are no validation or verification checkpoints (e.g., confirm R-peak detection, check signal quality), and biosignal batch processing warrants such feedback, capping it at 3. | 3 / 5 |
Progressive Disclosure | Good sectioning with eleven real one-level-deep reference files clearly signaled and content appropriately split between overview and references; minor gaps keep it from a 5: the reference list is plain paths rather than links and references/ecg_ppg exists but ppg.md is absent from the body's reference list despite PPG being a listed feature. | 4 / 5 |
Total | 16 / 20 Passed |