Content
85%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 well-structured orchestration skill: a clearly sequenced workflow with real validation checkpoints and user gates, supported by genuine one-level-deep bundle references and a routing table to sibling skills. The body stays lean and assumes Rerun competence; the only slack is minor framing prose, a few text glitches, and the high-level handoff at the 'write the conversion code' step.
Suggestions
Tighten the framing prose (e.g. the 'Every dataset is unique…' lead-in to Principles) and fix the text glitches — 'Run census undecodable channels' (missing 'on') and the line-wrapped Properties sentence ending '…`has_<attribute>`and the / census'.
Make the least concrete step, 'Write the conversion code using the skills', more actionable with a minimal reader + lens pipeline skeleton or a pointer to the exact rerun-chunk-processing section that mandates the pipeline shape.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is disciplined for an orchestration skill: a compact Terms table, tight DO/DON'T blocks ("DO NOT call `to_chunks()` in conversion code"), and it assumes Rerun/Arrow knowledge ("Rerun can store arbitrary Arrow-compatible data") without re-explaining it. Minor trimmable framing ("Every dataset is unique, which makes it hard to set universal guidelines…") and small text glitches ("Run census undecodable channels"; the broken line "`is_<validity>`, `has_<attribute>`and the / census") keep it below the lean-everywhere 5 anchor, but it is well above the some-unnecessary-explanation 3 anchor. | 4 / 5 |
Actionability | Concrete, specific instruction throughout: "Write a download script (with caching for faster lookup and options to select what to download)", "Add round-trip tests to ensure the conversion is lossless", "Build them with `Chunk.from_property`", and enumerated survey dimensions (FPS, GOP/codec, missing topics). As an instruction-only orchestration skill it routes executable code to the rerun-* skills and references, so steps like "Write the conversion code using the skills" stay high-level — mostly executable guidance with minor gaps rather than the copy-paste-ready 5. | 4 / 5 |
Workflow Clarity | Steps 0–7 are clearly sequenced with explicit validation and checkpoints: a dedicated conversion-check step ("Add round-trip tests… (original -> base -> original)", "Compare the file sizes… Investigate if there is a gap"), census error handling ("compare decoded rows against the source's own counts, flag the episode in a property, and store the raw bytes"), and user gates ("Pause for user to review the survey", "Pause for user to sign-off on the conversion mapping"). Not 4 because checkpoints are explicit rather than implicit and error paths (undecodable channels, size gaps) carry recovery handling. | 5 / 5 |
Progressive Disclosure | The body is a clear overview with well-signaled, one-level-deep references, each with stated scope: "`references/registering.md` carries the view commands, the registration template, and where querying is covered" and "Read `references/post-processing.md` before deriving a layer from data that is already converted". Both referenced files exist in the bundle, and the rerun-* routing table with a "When to read it" column makes navigation easy. Not 4 because content is appropriately split with no orphaned or buried references. | 5 / 5 |
Total | 18 / 20 Passed |