n8n Error Handling スキル
無人運用の n8n ジョブにエラー出力、再試行、ワークフロー単位の通知を設定します。
コミュニティ · Romuald Członkowski| 作者 | Romuald Członkowski |
|---|---|
| ライセンス | MIT |
| ソース | czlonkowski/n8n-skills · GitHub 上の SKILL.md |
| プロジェクトサイト | docs.n8n.io |
| 対応環境 | Claude Code · Codex、Gemini CLI、Cursor、Copilot |
| ソースを確認した日 |
n8n Error Handling スキル: 無人運用の n8n ジョブにエラー出力、再試行、ワークフロー単位の通知を設定します。
回復可能な障害を明確に分岐し、呼び出し側とサーバーのエラーを区別します。
スキルの SKILL.md より: # n8n Error Handling
できること
- 回復可能な障害を明確に分岐し、呼び出し側とサーバーのエラーを区別します。
得られるもの
- エラー分岐、再試行ポリシー、構造化応答、通知計画。
使う場面
- この webhook のエラー経路と応答ステータスを確認してください。
向かない場面
- 説明を、外部サービス・検証・公開の成功保証として使う場合。
必要なもの
- 互換性のある n8n-mcp サーバーと実際のワークフローデータが必要です。管理には認可済み n8n 環境が必要で、接続サービスやホスティングは別料金の場合があります。
スキルに含まれるファイル
| ファイル・フォルダー | 用途 |
|---|---|
SKILL.md | 入口指示とタスク固有の手順。 |
ERROR_WORKFLOWS.md | この手順で使う補足資料。 |
2026-11-17 時点でリポジトリに記載されていたライセンス:MIT。
プロンプト例
インストール後に次のいずれかを入力してください。スキル名を書くと確実にそのスキルが使われます。
- この webhook のエラー経路と応答ステータスを確認してください。
- 一時的な API 障害から、重複書き込みなしで復旧する計画を追加してください。
- 失敗しうる各ノードに実際のエラー出力先があるか確認してください。
n8n-error-handling のインストール方法
準備
リンク先はn8n製品資料で、コミュニティMCPのインストーラーではありません。n8n-mcpは別途導入し、料金とプラグインのフックを確認してください。
他のエージェントへのフォルダーコピーでは Claude Code のフックは導入されません。実行前に最新のツールスキーマと書き込みを確認してください。
スキルは SKILL.md ファイルを含むフォルダーです。インストールは一度だけで、エージェントは各セッションの開始時に短い説明を読み、リクエストが当てはまったときにだけ完全な指示を読み込みます。使う環境を選んでください:
Claude Code:プラグインマーケットプレイスから
- ターミナルで
claudeを実行して Claude Code を起動します。 - マーケットプレイスを追加します(パソコンごとに 1 回):
/plugin marketplace add czlonkowski/n8n-skills - プラグインをインストールします。Claude Code はまず詳細を表示するので、追加されるもの(スキル、フック、MCP サーバー)を確認し、自分用、このリポジトリの全員用、このリポジトリでの自分用のどれにするかを選びます。
/plugin install n8n-mcp-skills@n8n-mcp-skills - / を入力して
/n8n-mcp-skills:n8n-error-handlingを探すか、そのまま作業を依頼します。
セッション内ではなくシェルから行う場合:
claude plugin marketplace add czlonkowski/n8n-skills
claude plugin install n8n-mcp-skills@n8n-mcp-skillsプラグインは丸ごとインストールされるため、n8n-agents, n8n-binary-and-data, n8n-code-javascript, n8n-code-python, n8n-code-tool, n8n-expression-syntax, n8n-mcp-tools-expert, n8n-multi-instance, n8n-node-configuration, n8n-self-hosting, n8n-subworkflows, n8n-validation-expert, n8n-workflow-patterns, using-n8n-mcp-skills などほかのスキルも一緒に入ります。
Claude Code:スキルフォルダーにフォルダーをコピー
このパソコン上のすべてのプロジェクトで使うならスキルのフォルダーを ~/.claude/skills/ に、作業者全員で共有するならリポジトリ内の .claude/skills/ に置きます(コミットしてください)。
git clone --depth 1 https://github.com/czlonkowski/n8n-skills.git
mkdir -p ~/.claude/skills
cp -R n8n-skills/skills/n8n-error-handling ~/.claude/skills/Claude Code はセッション中にこれらのフォルダーで新しいスキルや変更されたスキルを検出します。セッション開始時にスキルフォルダーが存在しなかった場合は、/reload-skills を一度実行してください。その後 /n8n-error-handling と入力するか、作業内容をそのまま伝えます。
Windows では Git Bash または WSL でコマンドを実行するか、エクスプローラーで同じ場所にフォルダーをコピーしてください。
Codex、Gemini CLI、Cursor、GitHub Copilot
これらのエージェントも同じ SKILL.md フォルダーを読みます。4 つすべてがプロジェクト内で読むフォルダーは .agents/skills/ なので、次のコマンドでスキルをそこにコピーします:
git clone --depth 1 https://github.com/czlonkowski/n8n-skills.git
mkdir -p .agents/skills
cp -R n8n-skills/skills/n8n-error-handling .agents/skills/| エージェント | プロジェクトのフォルダー | ユーザーのフォルダー | メモ |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | $ と入力するか /skills を実行してスキルを選びます。タスクが当てはまれば Codex が自動で選ぶこともあります。 |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | または gemini skills install <git URL> --path <folder> --consent で Git からインストールします。Google は 2026 年 6 月 18 日、無料枠と Google One のユーザー向けに Gemini CLI を Antigravity CLI に置き換えました。Antigravity はプロジェクトでは .agents/skills/、ユーザー用には ~/.gemini/config/skills/ を使います。 |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Agent チャットで / を入力してスキルを選びます。Cursor は Claude Code の .claude/skills/ フォルダーも読みます。 |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Copilot CLI、クラウドエージェント、VS Code・Visual Studio・JetBrains のエージェントモードで動きます(IDE の対応はバージョンによります)。または gh skill install OWNER/REPOSITORY SKILL を実行します(パブリックプレビュー、GitHub CLI 2.90.0 以降)。 |
これらの手順の出典
2026-11-14 に各ベンダーのドキュメントと照合しました:
エラー接続の2つの設定
エラーモードと出力の接続を設定し、保存済みワークフローを読み直します。検証だけでは経路の到達性は証明できません。
全体のエラー保護
全体のエラー処理でノード分岐の漏れを補います。通知には実際のエラーと実行状況を含め、秘密情報は除外します。
n8n-error-handling に関するよくある質問
このサイトで実行しますか?
いいえ。出典に基づく導入ガイドです。設定済みのエージェント環境で実行します。
完全なクラウド手順は検証済みですか?
いいえ。汎用アップロードと API 実行手順は省略し、ローカル要件とホスト能力の確認が必要です。
continueErrorOutput だけで十分ですか?
いいえ。第2出力を実際のハンドラーにつながないと、エラーデータが失われる場合があります。
すべての失敗を再試行すべきですか?
いいえ。副作用と冪等性を理解したうえで、一時的な障害のみを再試行します。
ほかの AI スキル
関連スキル
n8n Node Configuration スキル
コミュニティ · Romuald Członkowski最新のスキーマ、操作、プロパティの依存関係に基づいて n8n ノードを設定します。n8n Validation Expert スキル
コミュニティ · Romuald Członkowskin8n の検証エラー、プロファイル、実行時の確認要件を読み解きます。n8n Binary and Data スキル
コミュニティ · Romuald Członkowskin8n ノード、エージェントツール、チャット間でファイルのバイト列とメタデータを保持します。n8n Sub-workflows スキル
コミュニティ · Romuald Członkowski型付き入力と明確な実行契約を持つ再利用可能な n8n ワークフローを切り出します。Using n8n MCP Skills スキル
コミュニティ · Romuald Członkowskin8nの設定・変更前にタスクを適切な専門スキルへ振り分けます。n8n MCP Tools Expert スキル
コミュニティ · Romuald Członkowskiノード探索・検証・管理に合うn8n-mcpツールを選びます。