n8n-docs-assistant

★ 195,330

by n8n-io · part of n8n-io/n8n

Answers n8n product, setup, credential, node, hosting, API, and usage questions from current n8n docs. Use when the user asks how to configure, set up, troubleshoot, or understand n8n behavior, especially credential setup questions opened from the credential modal.

🧰 Not standalone. This skill ships with n8n-io/n8n and only works together with that tool — install the tool first, then add this skill.

This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

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.

Default Procedure

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](https://github.com/n8n-io/n8n/blob/master/packages/@n8n/instance-ai/skills/n8n-docs-assistant/page URL) when one docs page was used, or Sources: when multiple docs pages were used. Use only pages returned by n8n-docs.

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.

Copy & paste — that's it

npx skills add https://github.com/n8n-io/n8n --skill n8n-docs-assistant

Run this in your project — your agent picks the skill up automatically.

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.