Content
85%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 skill body is highly actionable and well-sequenced with concrete code and validation checkpoints, though it carries some motivational padding. Its main weakness is progressive disclosure: two referenced reference files are named but do not exist in the bundle, leaving dangling pointers.
Suggestions
Add the missing SUBWORKFLOW_PATTERNS.md and NAMING_AND_DISCOVERY.md to the references/ bundle, or remove the references and inline the essential content so no pointer is left dangling.
Trim narrative/motivational prose (e.g. 'badly underused', 'quietly drift apart', 'ambushes every caller') to tighten conciseness while keeping the actionable guidance intact.
If keeping the reference split, ensure each referenced file is one level deep and self-contained (no further indirection), and verify the paths resolve before shipping.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly dense, domain-specific guidance, but carries motivational/narrative padding ('badly underused', 'quietly drift apart', 'ambushes every caller', 'earns its keep') that could be trimmed without losing actionable content. | 4 / 5 |
Actionability | Provides copy-paste-ready executable content — the workflowInputs trigger JSON block, concrete MCP calls (n8n_list_workflows, n8n_get_workflow, n8n_test_workflow, validate_workflow), the mode all-vs-each table, and a decision tree covering common cases. | 5 / 5 |
Workflow Clarity | Sequenced decision guidance, explicit contract rules, and a shipping checklist with validation checkpoints (validate_workflow, n8n_test_workflow) plus a field-rename feedback loop (migrate callers then verify); validation is present so no destructive/batch cap applies. | 5 / 5 |
Progressive Disclosure | The reference table is well-signaled with 'Read when' guidance, but the referenced bundle files (SUBWORKFLOW_PATTERNS.md, NAMING_AND_DISCOVERY.md) are not present in references/, scripts/, or assets/, so the one-level-deep references do not resolve and the detailed content is unavailable. | 3 / 5 |
Total | 17 / 20 Passed |