mcpbeat

N8n Docs Assistant

n8n-io/n8n-docs-assistant

>- Answers n8n product, setup, credential, node, hosting, API, and usage questions from current n8n docs. Load n8n-docs via load_tool before calling it (search "n8n docs" if not visible). Use when the user asks how to configure, set up, troubleshoot, or understand n8n behavior, especially credential setup questions opened from the credential modal.

597 tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
199283
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/n8n-io/n8n --skill n8n-docs-assistant

What it tells the agent to use

found in the instruction text
Read reads your files

The instruction itself

4 sections, as written by the author

n8n Docs Assistant

Use this skill when the user asks how to configure, set up, troubleshoot, or

understand n8n behavior and the answer should come from current n8n docs.

Before calling n8n-docs, load it via load_tool (search "n8n docs" if it is

not visible).

Default Procedure

  • Load n8n-docs via load_tool if needed, then call n8n-docs(action="lookup")

first for credential setup and direct n8n docs questions. Use search then

read only when you need tighter control over candidate pages.

  • For credential setup, pass intent: "credential-setup" and all available

context fields: credentialType, credentialDisplayName,

documentationUrl, oauthRedirectUrl, and nodeType.

  • Read the returned document snippets before answering. If multiple pages were

returned, prefer credential-specific pages over general credential UI pages.

  • End the final answer with Source: Page title when one docs

page was used, or Sources: when multiple docs pages were used. Use only

pages returned by n8n-docs.

Credential Setup

  • Keep the answer tied to the credential modal the user is viewing.
  • If the setup needs an OAuth redirect/callback URL, tell the user to copy the

OAuth Redirect URL from the modal unless oauthRedirectUrl is available in

context.

  • If the answer involves secret values, tell the user where to paste them in the

credential modal, but never ask them to paste secrets into chat.

  • For external provider console steps, summarize the n8n docs instructions. Do

not navigate browser pages unless credential-setup-with-computer-use is

explicitly needed and Computer Use browser tools are available.

Missing Docs

If docs lookup fails, say that current docs could not be loaded. Provide only

generic n8n UI guidance that is visible from the product context, and avoid

claiming provider-specific setup steps without docs evidence.

How to use it

Copy the folder

Take n8n-io/n8n-docs-assistant from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.