AI에게 일을 시키다 보면 같은 말을 반복하게 됩니다. "배포할 때는 이 순서로, 환경변수는 이렇게, 끝나면 이걸 확인해." 매번 설명하기도 번거롭고, 내가 깜빡 빠뜨리면 AI도 빠뜨립니다.
Skills(스킬)는 이런 설명을 파일로 적어 두고, 필요할 때 AI가 스스로 꺼내 읽게 하는 기능입니다.
9.1스킬은 폴더 하나, 문서 하나
스킬의 핵심은 SKILL.md라는 문서 하나입니다. Claude Code에서는 프로젝트의 .claude/skills/스킬이름/SKILL.md 위치에 둡니다.
---
name: deploy
description: 사이트를 배포하거나 배포 설정을 바꿀 때 사용
---
1. 배포 전에 npm run qa 로 테스트를 통과시킨다.
2. 환경변수는 대시보드에서만 바꾼다.
3. 배포 후 주요 페이지가 열리는지 확인한다.맨 위 --- 사이의 name과 description은 스킬의 이름표이고, 그 아래가 실제 매뉴얼입니다. 필요하면 참고 문서나 스크립트를 같은 폴더에 함께 넣을 수 있습니다.
9.2필요할 때만 꺼내 읽습니다
AI는 평소에 스킬의 이름표만 알고 있다가, 요청이 설명과 맞으면 그때 본문을 읽습니다. "배포해 줘"라고 하면 deploy 스킬을 펼쳐 보고 적힌 순서대로 일하는 식입니다. 그래서 스킬을 여러 개 만들어 두어도 AI가 헷갈리지 않습니다. /deploy 처럼 이름을 직접 불러 실행할 수도 있습니다.
9.3MCP, CLAUDE.md와 무엇이 다른가요?
- MCP8장는 도구입니다. AI가 DB나 브라우저 같은 바깥 세상에 손을 뻗게 해 줍니다.
- Skills는 노하우입니다. 그 도구를 언제, 어떤 순서로, 무엇을 조심하며 쓸지 알려 줍니다.
- CLAUDE.md4장는 매번 읽는 안내서입니다. 항상 지킬 짧은 규칙은 CLAUDE.md에, 가끔 필요한 긴 절차는 스킬에 둡니다.
둘은 함께 쓸 때 가장 좋습니다. 바이브공장장 홈페이지도 Supabase MCP로 DB에 연결하고, 보안 점검 스킬에 "결제·개인정보 코드를 바꾸면 이 항목들을 확인한다"를 적어 두었습니다.
9.4첫 스킬 만들기
어렵게 시작할 필요 없습니다. AI와 작업하다가 같은 설명을 두 번째 하게 되면 이렇게 말해 보세요.
"방금 설명한 순서를 스킬로 만들어 줘"AI가 SKILL.md를 써 줍니다. 한번 읽어 보고 빠진 부분만 보태면, 다음부터는 한마디로 같은 품질의 결과를 받을 수 있습니다.
JSON으로 데이터를 읽고, MCP로 도구를 연결하고, Skills로 일하는 방식을 가르친다. 이 셋이면 AI와 함께 일하는 기본기는 갖춘 셈입니다.
3부에서는 AI가 마음껏 고쳐도 안심할 수 있게 해 주는 안전장치부터 시작합니다. 10장에서는 Git을 알아보겠습니다.
— 9장 끝 —