Content
60%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 highly actionable and well-gated, with concrete templates, exact paths, and genuine validation checkpoints, and it uses its reference bundle appropriately with clear one-level-deep navigation. Its main weakness is token efficiency: a 544-line body that restates mode-selection, marker-preservation, and language-policy rules multiple times, much of it duplicating the reference files. Deduplicating the contract detail would materially raise conciseness without losing clarity.
Suggestions
State the ultra opt-in / regular save-prompt rule once (e.g., in Mode Selection) and reference it elsewhere instead of restating it in Artifact Ownership, the plan-exists section, and Guardrails.
Move the verbatim marker, status-value, and compatibility-heading preservation lists out of SKILL.md into ULTRA-RESEARCH-FORMAT.md, keeping only 'preserve the exact markers listed in references/ULTRA-RESEARCH-FORMAT.md' inline.
Compress the language/technical-terms policy in Step 0 to the three stored variables plus a one-line pointer, trimming the multi-bullet keep/translate/mixed exposition.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | At 544 lines the body restates the same rules repeatedly: the ultra opt-in / 'explicit regular restores the save prompt' rule appears in Mode Selection, Artifact Ownership context, the plan-exists section, and Guardrails; the verbatim-marker preservation list is enumerated twice (in the Step 0 language contract and the regular-mode save section) and again in ULTRA-RESEARCH-FORMAT.md; the language/technical-terms policy consumes dozens of lines. This matches anchor 2 ('noticeably verbose; several unnecessary explanations or padded sections') rather than 3 — the redundancy is systemic, not occasional. | 2 / 5 |
Actionability | Guidance is largely executable: exact config keys and read order in Step 0, an exact three-option save prompt, a complete research-file skeleton with literal markers, a concrete `mkdir -p "$(dirname ...)"` command, and a numbered 6-step ultra procedure. Minor gaps keep it from 5: the Research Coherence Gate criteria are partly abstract ('understandable without the conversation'), subagent delegation is hedged ('when supported'), and the 'Bundle Integrity Gate' is invoked without local definition. | 4 / 5 |
Workflow Clarity | Sequences are explicit and include real validation checkpoints with feedback loops: the Research Coherence Gate lists four numbered verification criteria, mandates 'Correct or qualify mismatches ... then re-run', and gates session-append on success; the regular save procedure is step-by-step with an option-driven prompt. It falls short of anchor 5 because execution order is scattered across topic-organized sections (config, ownership, mode selection, gates, save) with no single flow summary, and one referenced gate is undefined in this file. | 4 / 5 |
Progressive Disclosure | The bundle structure is solid: three real, well-scoped reference files (ULTRA-RESEARCH-FORMAT.md, PROJECT-HYPOTHESES.md, RETRY-HYPOTHESIS.md), each one level deep and explicitly condition-gated ('In ultra mode, read references/ULTRA-RESEARCH-FORMAT.md completely before choosing a slug'; 'Only when the user asks to ... track a project hypothesis'). It is not 5 because substantial ultra-contract detail (marker names, status values, compatibility headings, inclusion rationale) is inlined in SKILL.md and duplicated in ULTRA-RESEARCH-FORMAT.md rather than living solely in the reference. | 4 / 5 |
Total | 14 / 20 Passed |