Content
73%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 content is highly actionable with a well-sequenced, validated migration workflow. Its main weakness is progressive disclosure: the body dispatches to many agent and shared reference files that are not actually present in the skill bundle, so the structured navigation is not realizable.
Suggestions
Ship the referenced bundle files (agents/analyzer.md, agents/executor.md, agents/events.md, agents/webhooks.md, agents/admin-ui-sdk.md, agents/business-config.md, and shared/schema.md, shared/questions.md, shared/migration-warnings.md, shared/references.md) or remove the dispatch references from the body so navigation matches the actual bundle.
Move the verbose metadata-derivation rules and full output-text blocks into a shared reference file to tighten the SKILL.md body and improve token efficiency.
Either reference references/spectrum-s2-upgrade.md where relevant or remove it from the bundle so the bundle contents align with what the body cites.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and avoids explaining known concepts, but it is lengthy with full output text blocks and verbose metadata-derivation rules that could be tightened and partly delegated to reference files. | 3 / 5 |
Actionability | Fully executable guidance: exact agent dispatch paths, a complete app.commerce.config.ts template, exact flag behaviors, precise output strings, and concrete metadata derivation rules covering common cases. | 5 / 5 |
Workflow Clarity | A clear 5-step sequence with explicit [await] checkpoints, preflight and alreadyMigrated early-exit validation gates, correction loops, and error relay for a destructive migration — feedback loops are present throughout. | 5 / 5 |
Progressive Disclosure | The body references ten one-level-deep bundle files (agents/*.md, shared/*.md) as if they exist, but the actual bundle contains none of them (only references/spectrum-s2-upgrade.md, which the body never cites) — references point to missing files, breaking navigation. | 2 / 5 |
Total | 15 / 20 Passed |