← 보드로 돌아가기

n8n-io/skills

GitHub에서 열기 ↗
306
GitHub 스타
28
포크
Shell
언어
Apache-2.0
라이선스
2026.07.07
최근 푸시
2026.06.24
별표한 날

AI 분석

설치 난이도: 쉬움
큐레이터 노트
n8n을 사용하는 개발자나 팀이 코딩 에이전트를 통해 워크플로우를 효율적으로 구축 및 관리하려는 경우 도입을 고려할 가치가 높음. 특히 Claude Code나 Codex를 사용 중이라면 설치가 간편하고 즉시 활용 가능함.

강점

  • n8n 팀이 공식 제공하여 신뢰성과 지속적인 업데이트가 보장됨
  • 13개의 상세한 기능 스킬과 50개 이상의 참조 문서로 워크플로우 전반을 체계적으로 지원
  • SessionStart 및 PreToolUse 훅을 통해 에이전트가 자동으로 적절한 스킬을 로드하도록 설계됨

약점

  • Claude Code와 Codex 외의 플랫폼은 skills.sh를 통해 설치해야 하며 호환성이 제한적임
  • 일반 스킬 설치는 AGENTS.md에 수동 스니펫을 추가해야 하므로 초기 설정이 번거로울 수 있음
  • README에 데모 GIF가 아직 추가되지 않아 시각적 이해가 어려움

주의사항

  • n8n 인스턴스에 MCP 서버가 활성화되어 있어야 하며, 그렇지 않으면 Skills가 작동하지 않음
  • 플러그인 설치 후 Codex에서 훅 승인이 필요하며, 승인하지 않으면 일부 기능이 동작하지 않음
  • 기여 시 반드시 먼저 이슈를 열어 논의해야 하며, 사전 논의 없는 PR은 거절됨

시작 가이드

  • n8n 인스턴스에서 MCP 서버가 활성화되어 있는지 확인
  • 사용 중인 코딩 에이전트(Claude Code, Codex 등)에 맞는 설치 방법 선택 및 실행
  • 설치 후 AGENTS.md에 스니펫을 추가하여 일반 스킬 설치 환경에서도 작동하도록 설정

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

공식 n8n Skills

<!-- TODO: 15초 데모 GIF를 태그라인 앞에 추가 -->

n8n의 MCP가 연결을 만듭니다. n8n Skills가 표준을 설정합니다.

n8n 팀이 n8n의 인스턴스 수준 MCP 서버와 함께 사용하기 위해 구축했습니다. 이제 코딩 에이전트가 MCP를 통해 워크플로우를 구축하고 편집할 수 있으며, Skills를 통해 처음부터 올바르게 작업할 수 있습니다.

내용물:

  • 13개의 기능 스킬로 워크플로우 수명 주기 전반에 걸친 모범 사례를 다룹니다: 서브워크플로우 재사용, 표현식, 루프 및 페이지네이션, AI 에이전트, 오류 처리, 자격 증명, Data Tables, 디버깅 등.
  • 50개 이상의 참조 문서와 작업 예제를 필요 시 로드합니다: 노드별 주의사항, 결정 트리, 복사하여 붙여넣기 가능한 워크플로우 JSON / TypeScript SDK 스니펫.
  • SessionStart 훅은 모든 세션에서 프로토콜을 로드하며, 모든 n8n MCP 도구에 대한 간결한 참조를 포함합니다.
  • PreToolUse 훅은 에이전트가 영향력이 큰 MCP 호출 전에 해당 스킬을 참고하도록 유도합니다.

사전 요구 사항

인스턴스 수준 MCP 서버가 활성화된 n8n 인스턴스(모든 요금제, 클라우드 또는 자체 호스팅). 자세한 내용은 n8n의 MCP 설정 가이드를 참조하세요.

설치

플랫폼을 선택하세요:

  • Claude Code
  • Codex
  • 기타 플랫폼

Claude Code

Claude Code 내에서 다음 명령어를 하나씩 실행하세요:

/plugin marketplace add n8n-io/skills
/plugin install n8n-skills@n8n-io

Claude Code를 다시 시작하세요. Skills가 자동으로 로드됩니다.

Codex

다음 명령어를 하나씩 실행하세요:

codex plugin marketplace add n8n-io/skills
codex plugin add n8n-skills@n8n-io

Codex를 다시 시작하세요. 첫 실행 시 Codex가 플러그인의 훅을 검토하고 신뢰할지 묻습니다. 승인하면 SessionStart, PreToolUse, PostToolUse 알림이 작동합니다. Skills가 자동으로 로드됩니다.

기타 플랫폼

각 코딩 에이전트는 고유한 스킬 형식을 가지고 있습니다. 플랫폼 문서에 따라 Skills를 설치하세요.

skills.sh는 npx를 통해 몇 가지 인기 플랫폼을 지원합니다. 프로젝트 폴더에서 다음을 실행하세요:

npx skills add n8n-io/skills

호환성은 에이전트에 따라 다릅니다. 특정 플랫폼 지원 여부는 skills.sh에서 확인하세요.

그런 다음 AGENTS.md에 스니펫을 추가하세요

이 프로젝트는 n8n을 사용합니다. 워크플로우, 노드, 표현식 또는 n8n MCP 도구로 작업할 때는 항상 `using-n8n-skills` 메타 스킬을 먼저 로드하고, 그 라우팅에 따라 해당 기능 스킬을 참고한 후 작업을 수행하세요.

플러그인은 SessionStart 훅을 제공하여 진입점 스킬을 자동으로 로드합니다. 일반 스킬 설치는 해당 훅이 없으므로, 위 스니펫이 에이전트가 모든 n8n 작업을 시작할 때 using-n8n-skills를 로드하도록 안내합니다.

포함된 Skills

스킬 활성화 시점
n8n-workflow-lifecycle 워크플로우 시작, 설계, 구성, 완료 시
n8n-subworkflows 재사용 가능한 것, 다단계 빌드 시
n8n-extending-mcp MCP가 제공하지 않는 기능이 필요할 때
n8n-expressions {{}}, $json, $node 작성 시
n8n-node-configuration 노드 구성 시
n8n-code-nodes 사용자 정의 로직, Code 노드 고려 시
n8n-loops 루프, 배치, 페이지네이션 API 시
n8n-agents LangChain Agent 노드, 도구, 시스템 프롬프트, 구조화된 출력 시
n8n-error-handling 웹훅 API, 프로덕션 워크플로우 시
n8n-credentials-and-security 인증, API 키, 토큰 시
n8n-binary-and-data 파일, 이미지, 첨부 파일, 비전 시
n8n-data-tables Data Tables: 스키마, 중복 제거, 영구 상태 시
n8n-debugging 문제 발생 시

14번째 메타 스킬인 using-n8n-skills는 플러그인의 SessionStart 훅에 의해 로드되며, 모든 n8n 작업에서 에이전트를 올바른 기능 스킬로 안내합니다.

작동 방식

각 스킬은 마크다운 파일입니다. 프론트매터는 에이전트에게 언제 로드할지 알려줍니다. SessionStart 훅은 모든 n8n 작업에서 올바른 스킬로 라우팅하고, PreToolUse 훅은 영향력이 큰 MCP 호출 전에 해당 스킬을 컨텍스트로 다시 가져옵니다. 모두 마크다운일 뿐입니다. 결정에 동의하지 않으면 포크하세요.

관련 자료

기여

CLAUDE.md를 참조하세요. 인간과 AI 에이전트 모두를 위한 기여 가이드입니다. 먼저 이슈를 열어주세요. 이슈에서 논의되지 않은 PR은 받지 않습니다.

기여자 모집 중: 다른 코딩 에이전트(Cursor, OpenCode 등)를 위한 기능 동등 플러그인. Skills는 단순한 마크다운이며, 작업은 이를 래핑하여 Claude Code에서처럼 해당 환경에서 활성화되도록 하는 것입니다.

라이선스

Apache 2.0. LICENSE를 참조하세요.

원본 저장소: n8n-io/skills

라이선스: Apache-2.0

게재 제외를 원하시면 삭제 요청을 보내주세요.