This project provides a set of "skills" designed to enhance AI coding agents' ability to build and edit n8n workflows. It addresses the complexity of n8n development by offering contextual best practices, documentation, and examples directly within the agent's workflow. The target audience is developers and users leveraging AI agents for automation tasks within the n8n ecosystem, aiming to improve the accuracy and efficiency of workflow creation.

How It Works

The core approach utilizes markdown files as "skills," containing structured information and guidance for specific n8n functionalities. These skills integrate with n8n's instance-level MCP (Microservice Communication Protocol) server. A SessionStart hook automatically loads a meta-skill (using-n8n-skills), which then routes the agent to the appropriate capability skill. PreToolUse hooks further ensure that relevant skills are consulted before the agent executes high-impact MCP calls, embedding best practices directly into the agent's decision-making process. This markdown-centric, hook-driven system allows for contextual assistance and makes the underlying knowledge easily forkable.

Quick Start & Requirements

• Prerequisite: An active n8n instance (Cloud or self-hosted) with the instance-level MCP server enabled. Refer to n8n's MCP setup guide for configuration.
• Installation (Claude Code):

  /plugin marketplace add n8n-io/skills
  /plugin install n8n-skills@n8n-io
  Restart Claude Code.
  

• Installation (Codex):

  codex plugin marketplace add n8n-io/skills
  codex plugin add n8n-skills@n8n-io
  Restart Codex.
  

  (Approve plugin hooks on first run).
• Installation (Other Platforms): Use npx skills add n8n-io/skills from your project folder or consult platform-specific documentation. Check skills.sh for supported agents.
• Non-Plugin Setup: Add a snippet to your AGENTS.md file to load the using-n8n-skills meta-skill for each n8n task.

Highlighted Details

• Includes 13 distinct capability skills covering the n8n workflow lifecycle, sub-workflows, expressions, loops, AI agents, error handling, credentials, data handling, and debugging.
• Provides over 50 reference documents and worked examples, including node-specific advice and copy-pasteable workflow JSON/TypeScript SDK snippets, loaded on demand.
• Features a SessionStart hook that loads the protocol and a compact reference for n8n MCP tools upon session initiation.
• PreToolUse hooks proactively guide the AI agent to consult relevant skills before executing critical MCP commands.

Maintenance & Community

The project is actively seeking contributors to develop feature-parity plugins for other coding agents like Cursor and OpenCode. Development follows an issue-first approach, requiring discussion before pull requests are accepted. Refer to CLAUDE.md for detailed contribution guidelines.

Licensing & Compatibility

• License: Apache 2.0.
• Compatibility: Compatibility varies by AI coding agent. The skills.sh script provides details on supported platforms.

Limitations & Caveats

Agent compatibility is a primary concern, with varying levels of support across different platforms. Manual integration steps, such as modifying AGENTS.md, are required for platforms not utilizing the direct plugin system. The project is actively looking for community contributions to broaden its platform reach.