CH06 · 백업 · 보안 · 팀 공유

6-2. 팀원에게 스킬 전달하기 — 복사 한 번으로 관리 능력 이전

혼자만 n8n을 관리할 수 있으면 아쉽습니다. 만든 스킬을 팀원에게 넘기면 팀 전체가 같은 수준의 n8n 관리 능력을 갖게 됩니다. 이 클립에서는 스킬을 전달하는 세 가지 방법과, 팀원이 받은 후 진행해야 할 설정을 정리합니다.

1. 전달 방법 ① — 폴더 복사

가장 간단한 방법입니다. 스킬 폴더를 통째로 복사해 전달합니다.

# 스킬 폴더 위치
~/.claude/skills/my-n8n/
├── SKILL.md
├── workflow-builder/
│   └── workflow-builder.md
├── ops-manager/
│   └── ops-manager.md
└── references/
    └── ...

폴더를 압축해 슬랙으로 보내도 되고 USB로 전달해도 됩니다. 팀원은 받은 폴더를 자신의 ~/.claude/skills/ 아래에 배치하면 끝입니다.

cp -r my-n8n/ ~/.claude/skills/my-n8n/

2. 전달 방법 ② — Git 리포지토리

팀원이 여러 명이거나 스킬을 계속 업데이트할 계획이라면 Git 리포지토리가 더 적합합니다.

스킬 폴더를 GitHub 리포에 올리면 팀원 전체가 동일한 스킬을 clone할 수 있습니다. 스킬을 수정해도 팀원은 git pull 한 번으로 최신 버전을 받습니다.

# 스킬 리포 생성 및 푸시
cd ~/.claude/skills/my-n8n/
git init
git add .
git commit -m "n8n 관리 스킬 초기 버전"
git remote add origin https://github.com/our-team/n8n-skill.git
git push -u origin main
# 팀원이 클론
cd ~/.claude/skills/
git clone https://github.com/our-team/n8n-skill.git my-n8n

장점은 버전 관리입니다. 누가 언제 어떤 규칙을 수정했는지 이력이 남고, 문제가 생기면 이전 버전으로 되돌릴 수 있습니다.

3. 전달 방법 ③ — n8n-admin 도구 함께 전달

앞서 소개한 n8n-admin 도구도 함께 전달할 수 있습니다. DMG 파일과 .env 설정법만 알려주면 팀원은 GUI로도 n8n을 관리할 수 있게 됩니다.

전달할 것은 두 가지뿐입니다.

스킬은 Claude Code 안에서 자연어로, n8n-admin은 독립 앱에서 GUI로 관리합니다. 두 가지를 함께 전달하면 팀원이 상황에 따라 골라 쓸 수 있습니다.

4. 세 방법 비교

방법 ①

폴더 복사

  • 가장 빠르고 단순
  • 1회성 전달에 적합
  • 업데이트 추적 불가
방법 ②

Git 리포

  • 버전 관리 자동
  • 여러 팀원 동시 운영
  • git pull로 업데이트
방법 ③

n8n-admin 동봉

  • GUI 관리까지 포함
  • CLI와 GUI 병행
  • 비개발자에게도 부담 없음

5. 팀원이 받은 후 해야 할 일

순서대로 네 단계입니다.

STEP 1

Claude Code 구독 확인 — 스킬은 Claude Code 안에서 동작합니다. Pro 구독 상태인지 먼저 확인합니다.

STEP 2

.env 파일에 자기 서버 정보 입력 — .env.example을 복사해 .env로 이름을 바꾸고 자기 서버 URL과 API 키를 채웁니다.

STEP 3

스킬 폴더 위치 확인 — ~/.claude/skills/my-n8n/ 경로에 폴더가 들어가 있는지 확인합니다.

STEP 4

테스트 — Claude Code에서 "워크플로우 목록 보여줘"가 정상 동작하면 설정 완료입니다.

# 2번 단계 예시
cp .env.example .env
# 에디터로 열어서 자기 서버 정보 입력

6. 실습 — 전달 시나리오 시뮬레이션

스킬 폴더를 압축한 뒤 새 환경에 풀고 테스트합니다.

# 스킬 폴더 압축
cd ~/.claude/skills/
zip -r my-n8n-skill.zip my-n8n/

# 새 환경에서 압축 해제
cd ~/.claude/skills/
unzip my-n8n-skill.zip

압축을 풀고 .env를 설정한 뒤 Claude Code에서 "워크플로우 목록 보여줘"를 실행합니다. 목록이 정상적으로 출력되면 전달이 성공한 것입니다.

★ 핵심. 폴더 하나 + .env 설정, 단 두 가지만 전달하면 팀원이 동일한 n8n 관리 능력을 갖습니다.

7. 마무리

전달 방법 세 가지를 정리합니다.

폴더 복사

가장 간단하고 빠른 방법.

Git 리포

팀 규모가 크거나 스킬을 지속 업데이트할 때 적합.

n8n-admin 동봉

GUI 관리 도구까지 포함한 완전한 전달.

팀 전체가 같은 관리 능력을 갖게 되면 한 사람에게 업무가 집중되는 문제도 해결됩니다. 누구든 "워크플로우 백업해줘", "에러 현황 보여줘"라고 말하면 같은 결과를 얻습니다.

다음 클립에서는 범용 스킬을 우리 팀 상황에 맞게 커스터마이징하는 방법을 다룹니다.

다음 클립
6-3. 스킬 커스터마이징 — 우리 팀 상황에 맞게 모듈 수정하기
이어보기 →