Content
75%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 a lean, highly actionable runbook: it gives exact commands, cron mappings, a ready-to-fill recurring prompt, and a clear start/stop workflow with genuine error-recovery guardrails (KEEP/DISCARD/CRASH output reading and a crash-count auto-abort). The recurring gaps are a dangling script reference with no scripts/ bundle directory, minor duplication of the interval and expiry information, and no pre-flight validation before the cron job is created.
Suggestions
Verify or create the referenced {skill_path}/scripts/run_experiment.py (or inline the evaluation command) — the prompt template's core 'Evaluate' step depends on a script that does not exist in this skill bundle.
Deduplicate the interval presentation: the Step 2 selection menu and the interval-to-cron table repeat the same five options; merge them into a single table with descriptions and cron expressions.
Add a pre-flight checkpoint in Step 1 (e.g., confirm .autoresearch/{domain}/{name}/config.cfg and program.md exist and results.tsv is readable before calling CronCreate) so a bad experiment path fails fast instead of scheduling a broken recurring job.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — exact CLI examples, a cron mapping table, and a fill-in prompt template with no padding or explanations of concepts Claude already knows. However, the interval options are presented twice (the Step 2 selection menu and the interval-to-cron table) and the 3-day auto-expiry is stated in both the Step 5 confirmation block and the Important Limitations section, so minor trimming is possible. | 4 / 5 |
Actionability | Guidance is mostly executable: exact invocations, cron expressions, a complete fill-in cron prompt template, a loop.json schema, and a literal confirmation message. It falls short of fully copy-paste ready because the prompt references 'python {skill_path}/scripts/run_experiment.py' while no scripts/ directory exists in this skill bundle, leaving that command unverifiable. | 4 / 5 |
Workflow Clarity | The start sequence (resolve experiment → select interval → CronCreate → store loop.json → confirm) and the stop workflow are clearly ordered, and the recurring prompt contains real feedback loops ('Read the output (KEEP/DISCARD/CRASH)', 'If 5 consecutive crashes in results.tsv, delete this cron job (CronDelete) and alert'). It stops short of 5 because there is no pre-flight check that the experiment's config.cfg/program.md exist before scheduling, and no verification that CronCreate succeeded before writing loop.json. | 4 / 5 |
Progressive Disclosure | The file is well-organized with clear section headers (Usage, What It Does, Stopping a Loop, Important Limitations) and content appropriately sized for a single file. It misses a 5 because the one external path it references — {skill_path}/scripts/run_experiment.py — has no corresponding file in the bundle, and the related /ar:ar-status command is mentioned without any pointer to its location. | 4 / 5 |
Total | 16 / 20 Passed |