Content
63%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 a well-structured, actionable migration runbook with explicit validation and rollback steps. Its main weakness is progressive disclosure: an existing bundle file duplicates scenario content that is instead inlined in SKILL.md, and the body never references that file.
Suggestions
Link references/implementation.md from the body (e.g., under an 'Advanced scenarios' section) and move the duplicated export/import/dual-write scripts there, keeping SKILL.md as an overview.
Add an explicit fix-and-revalidate feedback loop in Step 4 (e.g., 'if variance >5%, inspect failing spans, re-run export/import for the gap, then re-validate').
Replace generic validation (count comparison only) with content-level checks for prompts/datasets to confirm parity, not just counts.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Prose is lean and assumes competence, but the body inlines four full TypeScript scripts plus bash that substantially duplicate the bundled references/implementation.md, so it could be tightened by offloading the bulk to the reference file. | 3 / 5 |
Actionability | Provides concrete, largely copy-paste-ready TypeScript and bash for export, import, dual-write, and validation, with only minor gaps (env-var setup, validation compares counts rather than content). | 4 / 5 |
Workflow Clarity | Steps 1-5 are clearly sequenced with an explicit validation checkpoint (Step 4: trace variance <5%), plus a rollback plan and error-handling table; the feedback loop on validation failure is implied rather than an explicit fix-and-revalidate cycle, keeping it just below the top anchor. | 4 / 5 |
Progressive Disclosure | The body has good section structure, but the bundle file references/implementation.md contains overlapping scenario content (export/import/dual-write/validation/rollback) and is never linked or signaled from the body, while that same content is inlined here. | 3 / 5 |
Total | 14 / 20 Passed |