2-4. [실습] n8n 관리 스킬 뼈대 만들기 — 첫 SKILL.md

이번 클립에서는 직접 스킬을 만듭니다. 처음부터 완성형을 짜는 것이 아니라 뼈대만 먼저 세우고, 다음 섹션부터 모듈을 하나씩 채워 가는 방식으로 진행합니다.

1. 스킬 폴더 생성

스킬이 들어갈 폴더부터 만듭니다. Claude Code에 다음과 같이 지시합니다.

".claude/skills/my-n8n/ 폴더를 만들어줘"

Claude Code가 mkdir -p 명령으로 폴더를 만듭니다. -p 옵션 덕분에 .claude 폴더가 없어도 중간 경로를 모두 함께 생성합니다.

폴더 이름을 my-n8n으로 정한 이유는 강사의 완성된 n8n 스킬과 구별하기 위해서입니다. 익숙해진 뒤에는 이름을 바꿔도 됩니다.

2. SKILL.md 작성 — 최소한의 뼈대

핵심 파일인 SKILL.md를 만듭니다.

".claude/skills/my-n8n/SKILL.md 파일을 만들어줘. 프론트매터에 name은 my-n8n, description에는 n8n 워크플로우 관리 스킬이라고 적어줘."

생성된 파일에는 세 부분이 들어갑니다.

1. 프론트매터

---
name: my-n8n
description: "n8n 워크플로우 관리 스킬 — n8n, 워크플로우, 자동화 관련 요청을 처리합니다"
---

description에 "n8n", "워크플로우", "자동화"가 들어 있습니다. 이 단어들이 스킬을 활성화하는 초인종입니다.

2. 모듈 라우팅 테이블 (비어 있음)

## 모듈 라우팅

| 요청 의도 | 모듈 파일 |
|-----------|-----------|
| (다음 섹션에서 추가) | (다음 섹션에서 추가) |

지금은 비어 있는 상태로 둡니다. 다음 섹션에서 모듈 파일을 만들면서 채워 갑니다.

3. 공통 규칙

## 공통 규칙
1. 작업 시작 전 n8n_health_check로 서버 상태를 확인한다.
2. 삭제나 전체 수정 같은 파괴적 작업은 반드시 사용자에게 확인받는다.
3. API 키나 비밀번호를 출력하지 않는다.

특히 첫 번째 규칙이 중요합니다. 서버가 꺼져 있는 상태에서 워크플로우를 만들려 하면 에러가 나기 때문입니다.

3. references 폴더 생성

모듈 파일이 들어갈 references 폴더를 만듭니다.

".claude/skills/my-n8n/references/ 폴더를 만들어줘"

지금은 폴더만 만들고 비워둡니다. 다음 섹션에서 워크플로우 생성 모듈을 만들면서 첫 번째 파일을 추가합니다.

현재까지의 구조는 다음과 같습니다.

.claude/skills/my-n8n/
├── SKILL.md          ← 프론트매터 + 빈 라우팅 테이블 + 공통 규칙
└── references/       ← 아직 비어 있음

지난 클립에서 본 구조와 동일한 형태입니다. 아직 알맹이는 없지만 뼈대는 완성됐습니다.

4. 테스트 — 스킬이 활성화되는지 확인

Claude Code 프롬프트에 다음을 입력합니다.

"n8n 관리해줘"

방금 만든 my-n8n 스킬을 인식하고 응답하면 성공입니다. description의 "n8n" 트리거 키워드가 작동한 결과입니다.

아직 모듈이 없으므로 실제 작업은 수행되지 않습니다. "스킬은 인식했지만 구체적인 작업 모듈이 아직 없습니다" 같은 응답이 나오는 것이 정상입니다.

★ 인식 실패 시 점검 포인트.<br />1. SKILL.md가 .claude/skills/my-n8n/ 경로에 정확히 있는지<br />2. 프론트매터의 --- 블록이 올바르게 열고 닫혔는지

5. 섹션 2 마무리

섹션 2 전체 흐름을 정리하면 다음과 같습니다.

스킬의 개념부터 제작까지 한 사이클을 마쳤습니다. 다만 아직 모듈이 비어 있는 뼈대 상태입니다.

다음 섹션에서는 첫 번째 모듈, 워크플로우 생성 모듈을 추가합니다. "날씨 알림 워크플로우 만들어줘"라는 한 마디로 Claude Code가 n8n에 진짜 워크플로우를 만들어 주는 경험을 직접 하게 됩니다.