This repository provides a set of 7 Claude Code skills designed to assist users in building production-ready n8n workflows programmatically. It targets users of n8n and Claude Code, aiming to overcome common challenges such as incorrect expression syntax, inefficient tool usage, validation errors, and misconfigured nodes, thereby enabling the creation of more robust and "flawless" automated workflows.

How It Works

The project offers specialized Claude Code skills that act as expert guides within an AI assistant's context. These skills teach AI assistants about n8n's intricacies, including correct expression syntax ({{}} patterns), effective utilization of n8n-mcp tools, proven workflow architectural patterns (e.g., webhook processing, HTTP API, database), validation error interpretation, and operation-aware node configuration. This approach provides structured, context-aware guidance, addressing common pitfalls and improving the quality and efficiency of workflow development.

Quick Start & Requirements

• Prerequisites:
  • n8n-mcp MCP server installed and configured.
  • Claude Code, Claude.ai, or Claude API access.
  • .mcp.json file configured with the n8n-mcp server details.
• Installation:
  • Plugin: plugin install czlonkowski/n8n-skills
  • Marketplace: Add marketplace (/plugin marketplace add czlonkowski/n8n-skills), then install (/plugin install n8n-mcp-skills).
  • Manual: git clone the repository and copy skills to ~/.claude/skills/.
  • Claude.ai: Download skill folders as zip, upload via Settings → Capabilities → Skills.
• Documentation: Installation Guide, Usage Guide, Development Guide, MCP Testing Log are available.

Highlighted Details

• Includes 7 complementary Claude Code skills.
• Supports over 525 n8n nodes.
• Leverages examples from 2,653+ n8n workflow templates.
• Provides comprehensive error catalogs and troubleshooting guides for validation issues.
• Skills activate automatically based on user queries related to n8n development.

Maintenance & Community

The project was conceived by Romuald Członkowski. Related projects include n8n-mcp and n8n. Contribution guidelines are available in DEVELOPMENT.md.

Licensing & Compatibility

The project is released under the MIT License, which is permissive and generally suitable for commercial use and integration into closed-source projects.

Limitations & Caveats

A significant limitation is noted for Python code nodes within n8n; the project advises using JavaScript for most cases (95%) due to Python's inability to use external libraries like requests or pandas. Users must be aware of these constraints when implementing Python code. The skills also require a functional n8n-mcp server and a compatible Claude environment.