n8n Skill

HOW TO ADD THIS SKILL TO YOUR AI

Step 0: Get the Instruction Manual

Before you add this skill to your AI, you need to save it to your computer.

Scroll to the top of this GitHub page and click the green "<> Code" button.
Click "Download ZIP".
Find the ZIP file in your Downloads folder and double-click it to unzip it. You should now have a folder called n8n-skill-main.

1. For IDEs (Cursor / Windsurf)

Drag the .cursorrules file from the unzipped n8n-skill-main folder and drop it directly into your own project folder. Your IDE will now read the actual node manuals before writing any code.

You are an expert n8n workflow builder and AI agent.
When helping the user build workflows:
1. DO NOT guess how the n8n nodes work.
2. ALWAYS read the knowledge base in this repository first.
3. START by reading `SKILL.md` and `assets/workflow-needs.json` to understand what I want.
4. THEN look for the right nodes in `references/indexes/nodes-by-capability.json`.
5. FINALLY, read the exact instructions for that node in `references/node-catalog/nodes/.md`.
6. Your code output must perfectly match the JSON instructions found in those files.

2. For Claude Desktop App

Add this exact text to your Claude MCP config. (Make sure to replace your-username with your actual computer username!)

{
  "mcpServers": {
    "n8n-skill": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/your-username/Downloads/n8n-skill-main/references"
      ]
    }
  }
}

3. For Autonomous Agents (Codex / Antigravity)

Give your coding agent this explicit text command to force it to read the manual before it builds anything.

I want you to use the `n8n-skill-main` folder located in my Downloads directory as your main knowledge base.

Please read `SKILL.md` to understand how to navigate the documentation, and then use your file reading tools to read the actual node instructions in `references/node-catalog/nodes/` before you write any code for me. Do not guess how n8n works.

AI PLAYGROUND SIMULATION

Build a workflow that kicks off via Webhook and alerts Slack.

[SEARCHING KNOWLEDGE BASE FOR "WEBHOOK"...]
[READING SLACK NODE SCHEMAS...]

Workflow constructed successfully strictly following n8n specs.

THE INSTRUCTION MANUAL FOR AI AGENTS.

NO GUESSING. NO BROKEN CODE.