2-3. 실전 스킬 해부 — 강사의 n8n 스킬을 한 줄씩 뜯어보기
앞 클립에서 배운 구조와 원리를 실제 파일에서 확인합니다. 강사가 운영 중인 n8n 관리 스킬을 펼쳐놓고 "왜 이렇게 썼는지"를 짚어봅니다.
1. 스킬 파일 열기
터미널에서 강사의 SKILL.md를 엽니다.
cat .claude/skills/n8n/SKILL.md이 한 장의 파일이 Claude Code를 n8n 전문 관리자로 변신시키는 업무 매뉴얼입니다. 위에서부터 차례로 읽어 내려갑니다.
2. 프론트매터 — 스킬의 이름표
파일 맨 위 ---로 감싸진 영역이 프론트매터입니다.
name: n8n— 스킬의 식별 이름. Claude Code가 내부적으로 이 이름으로 스킬을 호출합니다.description— 두 가지 역할을 동시에 수행합니다. 첫째, 스킬이 무엇을 하는지 설명. 둘째, 그 안에 트리거 키워드('n8n', '워크플로우', '자동화' 등)를 포함.
description 맨 끝에는 "자동화 단독 키워드는 n8n 컨텍스트가 있을 때만 트리거"라는 문구가 있습니다.
★ 조건부 트리거. "자동화해줘"만으로는 반응하지 않고, "n8n 자동화해줘"처럼 n8n 맥락이 같이 있어야 작동합니다. 불필요한 발동을 막는 안전장치입니다.
3. 모듈 라우팅 테이블 — 교통 안내판
라우팅 테이블은 표 형식의 네 줄로 구성됩니다.
| 요청 의도 | 모듈 파일 |
|---|---|
| 워크플로우 생성/수정/분석/개선 | workflow-builder.md |
| 실행 확인/실패 원인/상태 점검 | ops-manager.md |
| 튜토리얼/강의자료/실습 생성 | teaching-guide.md |
| 복합 요청 | ops → builder → teaching 순으로 동시 호출 |
네 번째 줄이 중요합니다. 복합 요청에서는 운영(ops)이 항상 최우선입니다. 서버가 죽어 있는데 워크플로우를 만들어봤자 소용없기 때문입니다. 현재 상태부터 확인하는 순서입니다.
테이블 아래에는 "의도가 불분명하면 사용자에게 확인한다"라는 규칙이 적혀 있습니다. AI가 지레짐작으로 행동하지 않게 막는 장치입니다.
4. 공통 규칙 — 모든 모듈이 지키는 약속
공통 규칙은 어떤 모듈이 실행되든 반드시 따라야 하는 세 가지 약속입니다.
시작 전 항상 실행
n8n_health_check로 인스턴스 상태 확인. 진료 전 혈압 측정과 같은 절차
노드 검색 패턴
search_nodes → get_node → validate_node의 3단계 절차로 노드를 다룸
안전 원칙
삭제·전체 업데이트 등 파괴적 작업은 사용자 확인 후 실행. 수정 전에는 n8n_workflow_versions로 버전 기록. 도구 사용법이 불확실하면 tools_documentation으로 문서 조회
이 세 가지 덕분에 AI가 실수로 중요한 워크플로우를 날려버리는 사고를 막을 수 있습니다.
5. MCP 도구 카탈로그 — 스킬의 손과 발
마지막은 MCP 도구 목록입니다. 총 21개 도구가 5개 그룹으로 분류되어 있습니다.
워크플로우 생명주기 8개
만들고, 조회하고, 수정하고, 삭제
검증 및 테스트 5개
워크플로우 동작 점검
실행 및 데이터 2개
실행 이력 조회와 데이터 관리
노드 및 템플릿 5개
노드 검색과 템플릿 활용
참조 1개
도구 사용법 문서 조회
스킬 문서가 뇌라면, MCP 도구는 실제로 n8n 서버를 조작하는 팔과 다리입니다. 각 도구의 세부 사용법은 다음 섹션에서 다룹니다.
6. 마무리
이 스킬 파일 하나에 담긴 구조는 다음과 같습니다.
프론트매터
이름과 트리거 키워드로 스킬을 식별
모듈 라우팅
요청 종류에 따라 적절한 모듈을 연결
공통 규칙
안전하고 정확한 작업을 위한 약속
MCP 도구 카탈로그
실제 작업을 수행하는 21개 도구 목록
이 네 요소가 마크다운 한 장에 모여 Claude Code를 n8n 전문 관리자로 변신시킵니다. 다음 클립에서는 직접 나만의 스킬 뼈대를 만들어봅니다.