CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

n8n-multi-instance

Use when an n8n-mcp account targets more than one n8n instance — i.e. the `n8n_instances` tool is available, the user mentions multiple n8n instances or environments (prod vs staging, several teams or clients), several agents or chats work on one account in parallel, a workflow / datatable / credential / execution call returns an unexpected NOT_FOUND or reads data you don't recognize, or a call is refused with `INSTANCE_AMBIGUOUS` or `INSTANCE_NOT_FOUND`. Covers naming the target instance on each call with the `instance` argument, setting the default with `switch`, verifying the target before high-stakes work — credential writes above all — and recovering from misroutes and fail-closes. Always consult this skill before operating on a specific instance, before any credential create/update/delete on a multi-instance account, or when a call hits the wrong/empty data or an instance error.

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews 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: every section carries unique instance-routing knowledge with executable calls, explicit validation before credential writes, and a complete error-recovery playbook. Its weaker spots are mild repetition of the shared-default and credential-safety rules, inline version-gating information, and no use of reference files despite a 230-line body.

Suggestions

Consolidate the shared-default hazard, which is explained three times (intro, 'How targeting behaves', 'Switching'): state the full mechanism once under 'How targeting behaves' and let the other two sections reference it in one line.

Move the error-envelope table and the INSTANCE_AMBIGUOUS deep-dive into a references/ file (e.g. errors.md) summarized by one line plus a pointer in Quick Reference, keeping the recovery playbook's do-this rows inline.

Place the version-availability note (backend 0.1.120+ / n8n-mcp 2.94.0+) in a short 'Older servers' section paired with its `switch` fallback, so time-sensitive gating information is segregated from the durable guidance.

DimensionReasoningScore

Conciseness

The body is dense with n8n-mcp-specific knowledge Claude cannot know (routing semantics, fail-close behavior, error envelopes) and explains nothing generic. Minor trimming opportunities remain: the shared-default hazard is restated in three sections (intro, 'How targeting behaves', 'Switching') and credential-safety rules in four, and the version-availability note ('backend 0.1.120+ / n8n-mcp 2.94.0+') is time-sensitive info placed inline rather than in a compat/deprecated section. Efficient with minor over-explanation → 4, not 5; not 3 since each repetition targets a distinct failure mode.

4 / 5

Actionability

Fully executable throughout: exact call shapes (`n8n_instances({mode:"list"})`, `n8n_manage_credentials({action:"create", …, instance:"client-a"})`), a numbered core workflow, a step-by-step copy-between-instances recipe with read/create/verify calls, concrete JSON error payloads, and a symptom→action recovery table. Copy-paste-ready guidance covering the common multi-instance cases matches the 5 anchor.

5 / 5

Workflow Clarity

Clear sequencing (Golden rules → numbered Core workflow → Recovery playbook) with explicit validation checkpoints at every high-stakes point: 'Check the name against `list` first' before credential writes, 'confirm current.name == "prod"' after a switch, 're-confirm current, then write', and 'verify on B' after a copy. Feedback loops exist for every error code, matching the 5 anchor. The destructive-operation cap does not apply because verification before credential writes is explicitly mandated.

5 / 5

Progressive Disclosure

A single self-contained file with well-labeled sections, a Quick Reference index, and named pointers to sibling skills, so navigation is easy. However, everything is inline — no bundle files or one-level-deep references exist, and at ~230 lines the error-envelope table and the INSTANCE_AMBIGUOUS deep-dive are plausible candidates for a separate reference file. Good structure with minor organization gaps → 4; not 5 because this is not an under-50-line skill where well-organized sections alone suffice.

4 / 5

Total

18

/

20

Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An excellent description: it states concrete capabilities and explicit, multi-situation trigger guidance in third person, with error-code triggers that are uniquely identifiable. Its only weakness is mild overlap with sibling n8n skills on broad triggers (generic NOT_FOUND, credential operations) that other skills in the same family also claim.

DimensionReasoningScore

Specificity

The description lists four concrete, distinct actions — 'naming the target instance on each call with the `instance` argument', 'setting the default with `switch`', 'verifying the target before high-stakes work', and 'recovering from misroutes and fail-closes' — which comprehensively covers the skill's lifecycle (per-call targeting, default management, verification, recovery). Matches the 5 anchor ('multiple specific concrete actions; comprehensive coverage') rather than 4, since no relevant action in the domain is left uncovered.

5 / 5

Completeness

Both halves are explicit: the 'what' ('Covers naming the target instance on each call with the `instance` argument, setting the default with `switch`, … and recovering from misroutes and fail-closes') and a concrete 'when' ('Use when an n8n-mcp account targets more than one n8n instance — i.e. the `n8n_instances` tool is available … Always consult this skill before operating on a specific instance'). Matches the 5 anchor with concrete trigger phrases; 4 would require a less explicit 'when', which is not the case.

5 / 5

Trigger Term Quality

Natural user-side triggers are comprehensively covered with synonyms: 'multiple n8n instances or environments (prod vs staging, several teams or clients)', 'several agents or chats work on one account in parallel', 'unexpected NOT_FOUND', 'reads data you don't recognize', and the literal error codes `INSTANCE_AMBIGUOUS`/`INSTANCE_NOT_FOUND` a user would paste back. Not 4, because no common natural term for this niche is missing.

5 / 5

Distinctiveness Conflict Risk

The skill has a clear, gated niche ('an n8n-mcp account targets more than one n8n instance') and unique error-code triggers (`INSTANCE_AMBIGUOUS` is exclusive to it), but broader triggers like 'a workflow / datatable / credential / execution call returns an unexpected NOT_FOUND' and 'credential create/update/delete' overlap with sibling n8n skills (the body itself notes n8n-mcp-tools-expert owns credential CRUD). Minor overlap risk with closely related skills matches the 4 anchor; not 5 because these shared triggers could fire the wrong n8n skill.

4 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

czlonkowski/n8n-skills

Path

skills/n8n-multi-instance/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.