Content
86%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, lean orchestration skill that assumes competence, lays out a clear required workflow with validation and stop-checkpoints, and cleanly delegates detail to a verified set of one-level-deep reference files. Its only gap is the absence of a complete executable migration script example inline.
Suggestions
Add one short end-to-end extraction→transform→import→validate script skeleton (e.g., a Node snippet using createOrReplace with deterministic IDs) to lift actionability from concrete commands to copy-paste-ready.
Spell out an explicit validate→fix→re-run feedback loop (e.g., 'run validation, on failure review per-document issue list, fix, re-run import with --replace, re-validate') to make the retry cycle as concrete as the rest of the workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient with no padding about what a CMS or migration is; assumes competence ('Treat migration as a content strategy and ETL project, not a blind lift-and-shift') and every section earns its place. | 5 / 5 |
Actionability | Provides concrete commands and identifiers ('createOrReplace', 'createIfNotExists', 'sanity datasets import --replace', 'defineType/defineField/defineArrayMember', the npx install command) and a concrete deliverable list, but includes no full copy-paste migration script example. | 4 / 5 |
Workflow Clarity | Clear required-workflow sequence with 'Stop and Ask' checkpoints and explicit validation requirements (count/sample/reference/redirect checks before cutover, validation summary), though a full inline validate→fix→retry loop is not spelled out. | 4 / 5 |
Progressive Disclosure | Clear overview pointing to real one-level-deep references (general.md first, then verified platform files aem/contentful/strapi/webflow/wordpress/payload/drupal/markdown) with a well-signaled Reference Map and no nested references. | 5 / 5 |
Total | 18 / 20 Passed |