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를 시작합니다. - 마켓플레이스를 추가합니다(컴퓨터마다 한 번):
/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는 세션 중에도 이 폴더의 새 스킬이나 변경된 스킬을 알아챕니다. 세션을 시작할 때 skills 폴더가 없었다면 /reload-skills를 한 번 실행하세요. 그런 다음 /n8n-error-handling를 입력하거나 작업을 설명하면 됩니다.
Windows에서는 Git Bash나 WSL에서 명령어를 실행하거나, 파일 탐색기로 같은 위치에 폴더를 복사하세요.
Codex, Gemini CLI, Cursor, GitHub Copilot
이 에이전트들은 같은 SKILL.md 폴더를 읽습니다. 네 가지 모두가 프로젝트 안에서 인식하는 폴더는 .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에 각 업체의 문서와 대조해 확인했습니다:
오류 연결의 두 단계
노드 오류 모드를 설정하고 오류 출력을 연결합니다. 저장된 워크플로를 다시 읽으세요. 검증만으로 경로 도달성을 입증할 수 없습니다.
전체 오류 보호
워크플로 수준 오류 처리로 노드 분기에서 놓친 오류를 처리합니다. 알림에는 실제 오류와 실행 문맥을 포함하되 비밀 정보는 제외하세요.
n8n-error-handling에 관한 질문
이 사이트가 실행하나요?
아니요. 출처 기반 설치 안내이며 구성한 에이전트 환경에서 실행합니다.
전체 클라우드 흐름을 검증했나요?
아니요. 일반 업로드와 API 실행 안내는 생략하며 로컬 요건과 호스트 능력은 여전히 필요합니다.
continueErrorOutput만 설정하면 충분한가요?
아니요. 두 번째 출력을 실제 처리기에 연결하지 않으면 오류 데이터가 조용히 사라질 수 있습니다.
모든 실패를 재시도해야 하나요?
아니요. 부작용과 멱등성을 이해한 경우에만 일시적 오류를 재시도하세요.
더 많은 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 도구를 선택합니다.