Content
77%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 exceptionally actionable — exact configs, exact tool calls, field-level gotchas — with a properly validated workflow and a well-signaled one-level reference structure. Its two weaknesses are redundant repetition of the standard-detail guidance across five sections and a reference layer whose four target files are absent from the evaluated bundle, leaving the deepest content unreachable.
Suggestions
Deduplicate the get_node standard-detail guidance: state it once in 'get_node Detail Levels' and trim its repetition in Configuration Philosophy, Core Concepts §3 (Progressive Discovery), Best Practices, and the Summary; drop the '56 seconds average between configuration edits' statistic, which adds no actionable value.
Ship the four referenced files (DEPENDENCIES.md, OPERATION_PATTERNS.md, NATIVE_NODES.md, NODE_FAMILY_GOTCHAS.md) in the bundle — e.g. under references/ — so the well-signaled links and anchors actually resolve.
Replace vague cross-references like 'the job-to-node table in `using-n8n-mcp-skills`' and 'See the n8n Workflow Patterns skill' with concrete resolvable paths or full skill names, so navigation does not depend on guessing where those live.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient but with real repetition: the "get_node standard detail is the default / covers 95% of needs / 1-2K tokens" guidance is restated in Configuration Philosophy, Core Concepts §3, get_node Detail Levels, Best Practices ("Do" #1), and the Summary; the "56 seconds average between configuration edits" statistic adds no operational value. Fits anchor 3 ('includes some unnecessary explanation or could be tightened') rather than 2, because the bulk of the body is dense, concrete specifics with no padding explaining concepts Claude already knows. | 3 / 5 |
Actionability | Fully executable throughout: copy-paste-ready configs for Slack post vs update, HTTP GET vs POST, IF conditions, and SplitInBatches output wiring; a complete six-parameter `n8n_explore_node_resources` call with the exact `{__rl: true, mode, value}` shape; and field-level fixes like `options.fallbackOutput`, `={{ { "blocks": ... } }}`, and a working `patchNodeField` operation. Specific examples cover the common cases, matching the top anchor. | 5 / 5 |
Workflow Clarity | The Standard Process (steps 1-8) embeds explicit validation checkpoints ("4. Validate configuration", "7. Validate again"), the Decision Tree sequences escalation from standard to search_properties to full, the validate-driven loop ("let each `validate_node` error surface the next required field") provides the error-recovery feedback loop, and the anti-patterns section forbids deploying without `validate_node`. Write/batch operations (database insert/update) are covered with validation and `alwaysOutputData` guidance, so no cap applies. | 5 / 5 |
Progressive Disclosure | References are clearly signaled one level deep with section anchors ("[DEPENDENCIES.md](DEPENDENCIES.md)", "[OPERATION_PATTERNS.md](OPERATION_PATTERNS.md#operation-specific-configuration-examples)", NATIVE_NODES.md, NODE_FAMILY_GOTCHAS.md) and each section carries a useful inline summary before deferring — but none of the four referenced files exist in the bundle (no references/ or any other directory), so every navigation target is missing/unverifiable. That is more than the 'minor organization gaps' of anchor 4, placing it at anchor 3. | 3 / 5 |
Total | 16 / 20 Passed |