2-2. 스킬 구조 + 작동 원리 (트리거, 라우팅, MCP)
스킬이 마크다운으로 쓰인 AI 업무 매뉴얼이라는 것은 지난 클립에서 정리했습니다. 이번에는 파일 구조와 그 구조가 실제로 어떻게 작동하는지의 원리를 한 번에 다룹니다.
1. 스킬의 파일 구조
스킬은 .claude/skills/ 폴더 안에 위치합니다. 강의에서 만들 n8n 관리 스킬의 구조는 다음과 같습니다.
.claude/skills/n8n/
├── SKILL.md ← 메인 파일 (진입점)
└── references/ ← 세부 모듈 폴더
├── workflow-builder.md
├── ops-manager.md
└── teaching-guide.md- SKILL.md: 스킬 전체의 진입점. 책으로 치면 표지와 목차를 합친 역할
- references/: 실제로 일하는 세부 모듈 파일이 모여 있는 폴더
회사에 비유하면 SKILL.md는 접수 데스크, references의 각 파일은 실무 부서에 해당합니다.
2. SKILL.md의 구성 요소
SKILL.md 안에는 네 가지 정보가 담깁니다.
프론트매터(Frontmatter)
파일 맨 위 ---로 감싼 블록. name과 description을 적는 스킬의 이름표
모듈 라우팅 테이블
어떤 요청을 어느 모듈로 보낼지 정한 안내판
공통 규칙
모든 모듈이 지켜야 할 안전 원칙
도구 목록
이 스킬이 사용할 수 있는 MCP 도구 리스트
SKILL.md 하나만 읽어도 이 스킬이 무엇을 할 수 있는지 전체 그림이 보여야 합니다.
3. 트리거 키워드 — 스킬을 깨우는 초인종
작동 원리의 첫 번째 메커니즘은 트리거 키워드입니다.
프론트매터의 description에 적힌 단어들이 트리거 역할을 합니다. 사용자의 입력 문장에 그 키워드가 포함되면 스킬이 활성화됩니다.
현관 초인종과 같습니다. 정해둔 단어가 초인종을 누르면 그제야 스킬이 잠에서 깨어납니다.
4. 모듈 라우팅 — 접수 데스크의 부서 배정
두 번째 메커니즘은 모듈 라우팅입니다. 스킬이 활성화되면 SKILL.md의 라우팅 테이블을 참고해 요청을 적절한 모듈로 넘깁니다.
회사 로비의 접수 데스크가 방문객의 용건을 듣고 법무팀·인사팀으로 안내하는 것과 같은 원리입니다.
5. MCP 도구 연결 — 스킬의 손과 발
세 번째 메커니즘은 MCP 도구 연결입니다. 라우팅을 통해 선택된 모듈 안에는 "이 작업에는 이 도구를 사용해라"라는 지시가 적혀 있습니다.
예를 들어 workflow-builder 모듈이 선택되면 다음 흐름이 일어납니다.
모듈이 n8n_create_workflow MCP 도구를 호출
MCP 서버가 요청을 받아 n8n API 실행
n8n 서버에서 실제 워크플로우 생성
★ 핵심. 스킬이 두뇌라면 MCP 도구는 손과 발입니다. 두뇌만으로는 실행할 수 없고, 손만으로는 무엇을 할지 모릅니다. 둘이 함께 있어야 자동화가 완성됩니다.
6. 전체 흐름 — 처음부터 끝까지
세 가지 메커니즘을 하나의 흐름으로 연결하면 다음과 같습니다.
이 세 단계가 순식간에 일어나기 때문에 사용자에게는 "말 한마디에 워크플로우가 뚝딱 만들어지는" 경험으로 보입니다.
7. 마무리
- 스킬은 SKILL.md(진입점)와 references 폴더(세부 모듈)로 구성됩니다.
- SKILL.md에는 프론트매터·모듈 라우팅 테이블·공통 규칙·도구 목록이 담깁니다.
- 트리거 키워드가 스킬을 깨우고, 모듈 라우팅이 적절한 모듈을 고르고, MCP 도구가 실제 작업을 수행합니다.
다음 클립에서는 강사가 실제로 사용하는 스킬을 열어 한 줄씩 해부합니다.