czlonkowski/n8n-skills

n8n skillset for Claude Code to build flawless n8n workflows

What it solves

AI によるプログラム的な n8n ワークフロー構築は、複雑な式構文、ツールの誤用、検証エラーのループ、ノード設定ミスなどが原因で困難になることがあります。このプロジェクトは、AI アシスタント（特に Claude）に本番環境向け n8n ワークフローを構築し、セルフホストインスタンスを正しくデプロイする方法を教える一連の「スキル」を提供します。

How it works

n8n-mcp MCP サーバー向けに設計された 14 の補完的スキルと実行レイヤーで構成されています。これらのスキルは、ユーザーのクエリに基づいて自動的に起動するエキスパートガイドとして機能します。JavaScript/Python コードノード、AI エージェント設計、バイナリデータ処理、エラーリカバリなど、特定のドメインをカバーします。フックとルータースキルを用いた「実行レイヤー」は、ツール使用前後に AI を正しいガイダンスへと積極的に誘導し、一般的なミスを防止します。

Who it’s for

Claude Code、Claude.ai、または Claude API を使用する開発者やオートメーションエンジニアで、n8n ワークフローの作成・検証・デプロイを自動化したい方。

Highlights

  • 14 Specialized Skills：式構文やノード設定から AI エージェント設計、サブワークフローまで網羅。
  • Proactive Enforcement：ルータースキルと前後ツールフックを使用し、AI が適切なパターンを適切なタイミングで使用することを保証。
  • Code Node Expertise：JavaScript と Python 向けの具体的なガイダンスを提供し、Webhook データアクセスなどの重要な「落とし穴」を解説。
  • Deployment Automation：Docker Compose と Caddy を用いた本番セルフホスト n8n インスタンスのデプロイ専用スキルを含む。
  • Validation Support：検証エラーを解釈し、エラーループをブレークするエキスパートスキルを搭載。