Content
88%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.
A strong, highly actionable body: dense n8n-specific guidance, concrete syntax and option values, and a validation-first workflow for both building agent nodes and managing persisted agents. The two gaps are embedded time-sensitive version pins in main prose and reference links pointing to files that are not present in the bundle.
Suggestions
Move version-specific claims (n8n 2.34+ prerequisite, the 2.36.x credential rejections, default maxIterations per version) into a dedicated 'Version notes' or 'Deprecated/old patterns' section so they don't age the core guidance.
Ship the referenced bundle files (TOOLS.md, SUBWORKFLOW_AS_TOOL.md, SYSTEM_PROMPT.md, STRUCTURED_OUTPUT.md, MEMORY.md, HUMAN_REVIEW.md, CHAT_AGENT_PATTERNS.md, RAG.md, EXAMPLES.md) in references/ so the Reference files table's links resolve.
Consider trimming the duplicated binary-boundary and anti-loop statements between the main sections and the checklist, keeping the checklist as the sole recap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence — every section carries n8n-specific facts (node-type short/long forms, connection-key placement, $json.output) rather than general LLM explanation. However, time-sensitive version pins are embedded directly in main prose ("n8n **2.34+**", "on n8n 2.36.x the agents runtime rejects azureOpenAiApi and aws credentials") rather than being isolated in a versioned/deprecated section, which the guidelines penalize. It sits above the 'mostly efficient' 3 anchor but short of the fully lean 5. | 4 / 5 |
Actionability | Fully executable guidance throughout: a copy-ready workflow-JSON connection snippet for ai_* wiring, the exact $fromAI() signature with per-argument semantics and types, concrete option values (maxIterations 15/50-200, contextWindowLength 50 vs the default 5), named HITL tool nodes, and exact mutate-action names with error codes (STALE_CONFIG, INVALID_ARGS, AGENT_TOOL_ERROR) and recovery steps. Specific examples cover the common cases. | 5 / 5 |
Workflow Clarity | Multi-step processes are clearly sequenced with explicit validation checkpoints and feedback loops: the persisted-agent build sequence (reference → discover_assets → create → mutate → validate → publish) mandates reading the schema first, validating before call/publish, re-getting on stale hash and retrying, and publishing only on explicit user request. The pre-ship checklist ends with validate_workflow and n8n_get_workflow verification, and the sub-node wiring rules state what validation flags as errors. | 5 / 5 |
Progressive Disclosure | Structure is strong: a clear overview with well-signaled one-level-deep references ("→ TOOLS.md", "→ STRUCTURED_OUTPUT.md") plus a dedicated Reference files table with a 'Read when' column, and explicit ownership boundaries delegated to sibling skills. However, none of the referenced files (TOOLS.md, EXAMPLES.md, MEMORY.md, etc.) exist in the bundle's references/ directory — no bundle files are present at all — so the navigation cannot be verified as real, keeping it below the 5 anchor's 'easy navigation'. | 4 / 5 |
Total | 18 / 20 Passed |