Content
72%Weight 40%Scale 1-3Reviews 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, well-structured, self-contained framework with a concrete handoff schema and a quality gate, but it would be more actionable with a worked example and clearer workflow sequencing. Adding a filled example and an explicit formulation procedure would raise the two mid-scoring dimensions.
Suggestions
Add one fully worked formulation example (filled handoff schema plus a short completed template) so the guidance is concrete and copy-paste ready rather than skeleton-only.
Provide an explicit ordered procedure for producing a formulation (e.g., 1. elicit observed data, 2. specify data model, 3. define target, …) with a review-against-quality-bar feedback step.
Keep the current lean structure; the only gap is moving from placeholders to a demonstrative filled instance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and purpose-built — an overview, an elements table, a typed handoff schema, a template, and a quality bar — with no padding explaining concepts Claude already knows, matching the "lean and efficient; every token earns its place" anchor. | 3 / 3 |
Actionability | It provides concrete artifacts (a YAML schema with typed enums like "iid | dependent | clustered" and a sectioned template), but the template is skeleton-only with placeholders ("Let …", "Assume …", "…") and lacks a single worked example, leaving the guidance incomplete. | 2 / 3 |
Workflow Clarity | A validation checkpoint exists via the Quality Bar ("passes only if another researcher could implement… without guessing"), but there is no explicit step sequence for performing the formulation and no feedback loop for review-fix-retry, matching the "steps present but checkpoints implicit" anchor. | 2 / 3 |
Progressive Disclosure | The skill is self-contained with no bundle files and is organized into clearly delineated sections (Overview, Required Formulation Elements, Handoff Schema, Template, Quality Bar) with no nested or broken references, satisfying the well-organized self-contained anchor. | 3 / 3 |
Total | 10 / 12 Passed |