Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is concise and well-structured with a clean one-level-deep reference, but actionability is uneven because the import and runner steps are prose-only in the body, and the batch workflow lacks an explicit validate-fix-retry feedback loop.
Suggestions
Add an executable code snippet for Step 3 (Import to Evernote) and Step 4 (Migration Runner) in the body, or at minimum a concrete command/function signature, instead of deferring entirely to the reference.
Make the validation feedback loop explicit in the body (e.g., 'after each batch: verify counts/hashes; on mismatch: restore from checkpoint, fix, re-run') rather than only describing checkpointing as a feature.
Tighten the format-descriptions in Step 2 (ENEX/JSON/Markdown parentheticals) to remove minor explanatory padding of formats Claude largely already knows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence: it avoids explaining what Evernote is and uses compact code, an error table, and short examples where every token earns its place, matching anchor 3. | 3 / 3 |
Actionability | Steps 1 and 2 provide executable JavaScript, but Steps 3 and 4 are descriptive prose ('Convert source data to ENML...', 'Build a migration runner...') with no executable code in the body, deferring details to the reference, matching anchor 2 rather than 3. | 2 / 3 |
Workflow Clarity | The four steps are clearly sequenced and verification is mentioned ('Verify each import by comparing note counts and content hashes'), but the body lacks an explicit validate-fix-retry feedback loop for this batch/destructive operation, which the guidelines cap at 2. | 2 / 3 |
Progressive Disclosure | SKILL.md is a concise overview that defers full details to a single well-signaled one-level-deep reference ('see [Implementation Guide](references/implementation-guide.md)') which exists, matching anchor 3. | 3 / 3 |
Total | 10 / 12 Passed |