Content
68%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 concrete, well-structured workflow skill with copy-paste-ready cron mappings and a complete scheduling prompt, weakened mainly by missing validation/feedback loops for its batch operations and a referenced script that has no corresponding bundle file.
Suggestions
Add an explicit validate→fix→retry checkpoint after the evaluate step (e.g., interpret KEEP/DISCARD/CRASH, and on DISCARD or CRASH roll back the commit before the next iteration) to lift workflow clarity above the batch-operation cap.
Clarify the KEEP/DISCARD/CRASH output format and what action each verdict triggers, since the prompt references it but never defines it.
Either provide the referenced scripts/run_experiment.py in a scripts/ bundle or inline its contract so the run command is genuinely executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — tables for cron mappings, a filled-in CronCreate prompt template, and concise numbered steps — with only minor trim opportunities such as the 3-day auto-expiry note repeated in both the confirm output and the Limitations section. | 4 / 5 |
Actionability | Mostly executable: concrete cron expressions, a complete CronCreate prompt template, explicit file paths (.autoresearch/{domain}/{name}/...), and real git/python commands; minor gaps like 'list experiments and let user pick' and the unexplained KEEP/DISCARD/CRASH output keep it from a 5. | 4 / 5 |
Workflow Clarity | Steps 1–5 are clearly sequenced and the crash-threshold rule ('If 5 consecutive crashes... delete this cron job and alert') is a feedback checkpoint, but this batch/destructive skill (automated commits, experiment runs, cron deletion) lacks a general validate→fix→retry loop, capping it at 3 per the feedback-loop guideline. | 3 / 5 |
Progressive Disclosure | The body is well-organized into clear sections (Usage, What It Does, Stopping, Limitations) with no nested references; the only external reference, 'python {skill_path}/scripts/run_experiment.py', points to a scripts/ directory that does not exist, a minor organization gap. | 4 / 5 |
Total | 15 / 20 Passed |