Content
70%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 highly actionable with strong, well-sequenced validation workflows and explicit safeguards for destructive and batch operations. Its main weaknesses are noticeable redundancy across repeated tables and summary sections, and progressive disclosure that points to guide files not actually bundled with the skill.
Suggestions
Ship the four referenced guide files (SEARCH_GUIDE.md, VALIDATION_GUIDE.md, WORKFLOW_GUIDE.md, OPERATIONS_GUIDE.md) in the bundle, or remove the dead links and inline only what is needed.
Remove redundancy: drop the Performance Characteristics table (its speeds duplicate the Quick Reference table) and trim the Summary section that restates Best Practices and Tool Categories.
Collapse the Common Mistakes table where it restates the Critical nodeType Formats and Node JSON Hygiene sections, keeping one canonical location.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Core content is dense and largely n8n-mcp-specific knowledge Claude would not already know, but the 480-line body has real redundancy: tool speeds appear in both the Quick Reference table and the Performance Characteristics table, the Common Mistakes table restates the nodeType/credential sections, and the Summary restates Best Practices. | 3 / 5 |
Actionability | Provides concrete executable guidance with exact tool signatures and parameter formats (e.g. `search_nodes({query: "slack"})`, credential nesting `{httpHeaderAuth: {id, name}}`, nodeType prefix rules); a few examples are illustrative ❌/✅ comments rather than full runnable scripts, and full worked examples are deferred to the guides. | 4 / 5 |
Workflow Clarity | Multi-step processes are clearly sequenced with explicit validation feedback loops ("validate → fix → validate again until clean") and destructive/batch safeguards ("use dryRun: true before bulk changes", "confirm with the user before dropping a populated column", "Confirm with the user before running a workflow that writes anywhere"). | 5 / 5 |
Progressive Disclosure | Structure is sectioned and references are clearly signaled and one-level-deep, but the four referenced guide files (SEARCH_GUIDE.md, VALIDATION_GUIDE.md, WORKFLOW_GUIDE.md, OPERATIONS_GUIDE.md) are not present in the bundle, so the navigation links are broken, and substantial detail that the guides are meant to offload remains inlined in the long body. | 3 / 5 |
Total | 15 / 20 Passed |