Content
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-organized, concise instruction skill that routes to per-step-type references and gives concrete syntax rules with right/wrong pitfall pairs. Its main gap is the absence of an explicit validation/checkpoint step after MCP step writes, which keeps workflow clarity below top.
Suggestions
Add an explicit validation checkpoint after writing step controls (e.g., re-read the step via the MCP or confirm editorType/variables resolve) so the workflow has a verify-then-fix feedback loop.
Surface a short post-edit checklist (variables resolve, no hardcoded URLs, editorType preserved, conditions merged vs replaced as requested) that mirrors the Common Pitfalls section as a closing verification step.
Make the recommended order explicit in one line — e.g. 'identify the step type → open its reference → fill controls → run the verification checklist' — so the sequence is unambiguous rather than implied by section order.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean body that assumes Claude knows Novu concepts — no padding explaining what Novu or workflows are — with rules given as tight bullets and concrete syntax examples; every section earns its place. | 3 / 3 |
Actionability | Concrete, specific guidance throughout — exact Liquid variable syntax ({{ subscriber.firstName }}, {{ payload.* }}), bare-vs-curly rules for Block Editor, and right/wrong pitfall pairs — which is actionable for an instruction-only skill even without executable code. | 3 / 3 |
Workflow Clarity | A clear sequence is present (When to use → Step Content Guidelines → step-type table → Common Pitfalls) and the pitfalls act as a checklist, but there is no explicit validation/checkpoint step for verifying MCP-written step content, so it sits at the 'sequence present but checkpoints implicit' level rather than 3. | 2 / 3 |
Progressive Disclosure | SKILL.md is a concise overview with one-level-deep references via the step-type table and inline links; all 10 referenced files (email-step.md, in-app-step.md, etc.) exist under references/ and navigation is easy. | 3 / 3 |
Total | 11 / 12 Passed |