Content
77%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.
An unusually rigorous procedure: mandatory phase order, bounded repair loops, artifact contracts, and a well-executed two-profile progressive-disclosure split with all referenced files verified present. Its weakness is token efficiency — several multi-sentence rationales are stated two or three times and rhetorical framing pads the rules — and one garbled sentence in rule 1 leaves the --target/--profile guidance incomplete.
Suggestions
State each rationale once and cross-reference it: the 'per-issue parse is meaningless' argument appears in 'Validation is deliberately at the end', again in Step 5, and again in Step 7; the human-confirmation rule appears in the automation_type table, rule 4, and Step 6; the dead-config flag warning appears in the intro and Step 5. Cut to one canonical statement plus a pointer.
Repair the fragment in Non-negotiable rule 1 — "`--target`/`--profile` to point somewhere else, and never a warehouse the session was not already connected to" is missing its verb (presumably "Never pass `--target`/`--profile` ..."); as written, the reader must guess the instruction.
Trim persuasive framing ("all of which have been violated in testing", "which makes it the easiest to forget; it is not exempt", "a plausible-looking path you invent turns a warning into a real breakage") — state the rule and its consequence in one clause instead of arguing for it.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The core content (steps, schemas, status values) is dense and load-bearing, but whole rationales are repeated: why validation is at the end is explained three times ("Validation is deliberately at the end, not per issue", the Step 5 "do not run the parse gate after each one" paragraph, and Step 7's parse-failure guidance); "never apply a `human` issue without confirmation" appears three times; "a flag for a behavior the project does not use is dead config" appears twice; and persuasive asides ("all of which have been violated in testing", "it makes rule 7 load-bearing") argue for rules rather than state them. This is more than the level-4 anchor's 'minor instances of over-explanation', but well short of the level-2 anchor's pervasive padding. | 3 / 5 |
Actionability | Highly executable: exact operation invocations with verbatim notes ("status-set → preflight = waiting_input, note 'Continue on branch <branch>?'", "ask: 'You are on branch `<branch>` with a clean tree. Continue the migration here?'"), complete JSON artifact schemas, and enumerated legal status values. Falls short of anchor 5 only on a garbled fragment in rule 1 — "`--target`/`--profile` to point somewhere else, and never a warehouse the session was not already connected to" is missing its verb, leaving that instruction's intent to inference. | 4 / 5 |
Workflow Clarity | A mandatory 10-step execution order with per-phase status-set open/close, an ordered verification gate ("dbt parse is mandatory and always first", "Stop at the first one that fails") with bounded feedback loops ("max 5 whole-project attempts", "Max 3 command-loop attempts"), revert-on-failure, a re-detection step confirming fixes held, and explicit end-of-step checklists ("Nothing should remain `detected` ... confirm with `list-issues --status detected,pending`"). This matches the anchor with explicit validation, error-recovery loops, and checklists. | 5 / 5 |
Progressive Disclosure | Clean one-level-deep split, all verified present: rules and invariants in SKILL.md; mechanics in exactly one of two profile files selected by a decision table ([references/exec-local.md], [references/exec-platform.md], "Load **exactly one**"); per-migration data in `references/kb_<FROM>_<ADAPTER>.json` bundles (66 present, matching the documented naming convention) loaded via `load-bundle`. The body correctly does not inline mechanics or the issue corpus, and navigation signals ("no shell means Studio") are explicit. | 5 / 5 |
Total | 17 / 20 Passed |