Content
77%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 highly actionable with a clear, validated multi-step migration workflow, but it is held back by an orphaned bundle reference (implementation-guide.md is never linked) and notable content overlap between the body and that reference.
Suggestions
Add a clearly signaled pointer to references/implementation-guide.md (e.g., an 'Advanced / full implementation' section linking to it) so the bundle file is discoverable from SKILL.md.
Reduce overlap by trimming the inlined full code blocks that the implementation guide already covers, keeping SKILL.md as a lean overview and delegating detail to the reference.
Remove the unexplained `## Current State` (`npm list`) artifact, and note in the reconciliation step that only a 100-record sample is verified (or expand it) so the validation scope is explicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient TypeScript with little explanatory padding, but the body duplicates much of references/implementation-guide.md (field mapping, batch worker, validation, rollback) and includes an unexplained `## Current State` (`npm list`) artifact, so it could be tightened. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready TypeScript against real endpoints (e.g. `POST /contacts/bulk_create`, `/contacts/search`) with concrete field mappings and rate-limit handling, matching the 'fully executable code/commands' anchor. | 3 / 3 |
Workflow Clarity | Steps 1–5 are clearly sequenced (mappings → assessment → batch migration → reconciliation → rollback) with explicit validation checkpoints (pre-migration assessment, a >10%-invalid gate, reconciliation, and a rollback path), so batch/destructive validation is present rather than missing. | 3 / 3 |
Progressive Disclosure | Sections are well-organized, but references/implementation-guide.md is never linked or signaled from the body, and detailed code that could live in the reference is inlined — matching 'references present but not clearly signaled; content that should be separate is inline'. | 2 / 3 |
Total | 10 / 12 Passed |