요약: Claude Code의 "Skill" 기능을 사용하면, 복잡한 회사 시스템의 규칙과 구조를 AI에게 미리 가르쳐둘 수 있습니다. 개발자가 아니어도 간단한 마크다운 문서만 작성하면 됩니다.
왜 Skill이 필요한가요?
회사마다 고유한 업무 방식이 있습니다:
Claude에게 매번 이걸 설명하는 건 비효율적입니다. Skill을 한 번 설정해두면, Claude가 자동으로 기억하고 적용합니다.
저희 BKAMP 프로젝트는 상당히 복잡한 시스템입니다:
| 구성 요소 | 규모 |
|---|---|
| 백엔드 서비스 | 12개 (인증, 사용자, 프로젝트, 커뮤니티 등) |
| 프론트엔드 | Next.js + 공유 패키지 |
| 인프라 | Docker, AWS EKS, ArgoCD |
| 지원 언어 | 8개국어 (한국어, 영어, 일본어 등) |
이런 복잡한 시스템에서 Claude가 실수 없이 코드를 작성하려면, 시스템의 규칙을 미리 알려줘야 합니다.
bkamp-architecture)"어느 폴더에 파일을 만들어야 해?" "서비스들이 어떻게 연결되어 있어?"
이런 질문에 Claude가 바로 대답할 수 있도록, 시스템 구조를 문서화했습니다.
트리거 조건: 코드 수정, 버그 수정, 기능 추가 시 자동 적용
bkamp-api-conventions)"API 응답은 어떤 형식이어야 해?" "에러 코드는 뭘 써야 해?"
모든 API가 일관된 형식을 따르도록 규칙을 정의했습니다.
트리거 조건: API 엔드포인트 작성, 에러 처리 시 자동 적용
bkamp-i18n)"번역은 어떻게 추가해?" "새 언어를 지원하려면?"
8개국어 번역 시스템의 사용법을 정리했습니다.
트리거 조건: 번역, 다언어 지원 작업 시 자동 적용
bkamp-infra)"로컬에서 어떻게 실행해?" "배포는 어떻게 해?"
개발 환경부터 프로덕션 배포까지의 가이드입니다.
트리거 조건: Docker, 배포, DevOps 관련 작업 시 자동 적용
bkamp-review)"내가 짠 코드가 맞는지 확인해줘" "빠진 부분 없어?"
프론트엔드부터 데이터베이스까지 전체 레이어를 검증합니다.
트리거 조건: "검수해줘", "리뷰해줘" 요청 시 자동 적용
bkamp-service-dev)"새 API는 어떻게 만들어?" "데이터베이스 모델은?"
백엔드 개발의 표준 패턴을 정의했습니다.
트리거 조건: 서비스 코드 수정, API 추가 시 자동 적용
Skill은 단순한 마크다운 문서입니다. 복잡한 코드가 아니에요.
markdown--- name: my-skill-name description: 이 Skill이 언제 적용되는지 설명합니다. 특정 작업을 할 때 자동으로 적용됩니다. --- # 제목 여기에 Claude가 알아야 할 내용을 적습니다. ## 규칙 1 - 이렇게 하세요 - 이건 하지 마세요 ## 규칙 2 ...
| 요소 | 설명 | 예시 |
|---|---|---|
name | Skill의 고유 이름 | customer-support-guide |
description | 언제 자동 적용될지 | "고객 문의 처리, 환불 요청 시 자동으로 적용됩니다" |
| 본문 | Claude가 참고할 내용 | 규칙, 절차, 형식 등 |
프로젝트 폴더/ └── .claude/ └── skills/ └── my-skill-name/ └── SKILL.md
비개발자를 위한 Skill 활용 예시 - 예시 1: 고객 지원팀
markdown--- name: customer-support description: 고객 문의 응대, 환불 처리, 불만 접수 관련 작업 시 자동으로 적용됩니다. --- # 고객 지원 가이드 ## 응대 원칙 - 항상 존칭 사용 (고객님) - 24시간 내 첫 응답 - 환불은 7일 이내만 가능 ## 응답 템플릿 ### 일반 문의 "안녕하세요, [고객명]님. [회사명]입니다..." ### 환불 요청 "환불 요청 접수되었습니다. 처리 기간은..."
비개발자를 위한 Skill 활용 예시 - 예시 2: 마케팅팀
markdown--- name: brand-guide description: 마케팅 문구 작성, SNS 포스팅, 보도자료 작성 시 자동으로 적용됩니다. --- # 브랜드 가이드 ## 톤앤매너 - 친근하지만 전문적 - 이모지는 SNS에서만 사용 - "혁신", "최고" 같은 과장 표현 금지 ## 금지어 - ~~업계 최초~~ → "새로운 시도" - ~~완벽한~~ → "신뢰할 수 있는"
비개발자를 위한 Skill 활용 예시 - 예시 3: 재무팀
markdown--- name: expense-report description: 지출 보고서 작성, 경비 정산, 예산 문서 작업 시 자동으로 적용됩니다. --- # 경비 보고서 규칙 ## 필수 항목 1. 날짜 (YYYY-MM-DD 형식) 2. 사용처 3. 금액 (원 단위, 천 단위 콤마) 4. 사용 목적 5. 영수증 첨부 ## 승인 기준 - 10만원 미만: 팀장 승인 - 10만원 이상: 본부장 승인
마무리 - Skill의 마법: "자동 적용"
가장 중요한 건 description에 적힌 조건입니다.
description: 고객 문의 처리, 환불 요청 시 자동으로 적용됩니다.
이렇게 적어두면, 사용자가 "고객 문의에 답변해줘"라고 말할 때 Claude가 자동으로 이 Skill을 참고합니다.
사용자는 Skill의 존재를 몰라도 됩니다. Claude가 알아서 적용합니다.
| 질문 | 답변 |
|---|---|
| Skill이 뭔가요? | Claude에게 회사 규칙을 가르치는 문서예요 |
| 개발자만 쓸 수 있나요? | 아니요, 마크다운만 알면 누구나 가능해요 |
| 매번 적용해야 하나요? | 아니요, 조건에 맞으면 자동 적용돼요 |
| 어디에 저장하나요? | .claude/skills/폴더명/SKILL.md |
.claude/skills/ 폴더 만들기my-guide/)SKILL.md 파일 만들고 내용 작성하기복잡해 보이지만, 결국 **"Claude가 알아야 할 것들을 정리해서 특정 폴더에 저장"**하는 것뿐입니다.
핵심 메시지: Skill은 "Claude의 회사 온보딩 문서"입니다. 신입 사원에게 주는 가이드북처럼, Claude에게 우리 회사만의 규칙을 알려주세요.
댓글을 작성하려면 로그인이 필요합니다.
요약: Claude Code의 "Skill" 기능을 사용하면, 복잡한 회사 시스템의 규칙과 구조를 AI에게 미리 가르쳐둘 수 있습니다. 개발자가 아니어도 간단한 마크다운 문서만 작성하면 됩니다.
왜 Skill이 필요한가요?
회사마다 고유한 업무 방식이 있습니다:
Claude에게 매번 이걸 설명하는 건 비효율적입니다. Skill을 한 번 설정해두면, Claude가 자동으로 기억하고 적용합니다.
저희 BKAMP 프로젝트는 상당히 복잡한 시스템입니다:
| 구성 요소 | 규모 |
|---|---|
| 백엔드 서비스 | 12개 (인증, 사용자, 프로젝트, 커뮤니티 등) |
| 프론트엔드 | Next.js + 공유 패키지 |
| 인프라 | Docker, AWS EKS, ArgoCD |
| 지원 언어 | 8개국어 (한국어, 영어, 일본어 등) |
이런 복잡한 시스템에서 Claude가 실수 없이 코드를 작성하려면, 시스템의 규칙을 미리 알려줘야 합니다.
bkamp-architecture)"어느 폴더에 파일을 만들어야 해?" "서비스들이 어떻게 연결되어 있어?"
이런 질문에 Claude가 바로 대답할 수 있도록, 시스템 구조를 문서화했습니다.
트리거 조건: 코드 수정, 버그 수정, 기능 추가 시 자동 적용
bkamp-api-conventions)"API 응답은 어떤 형식이어야 해?" "에러 코드는 뭘 써야 해?"
모든 API가 일관된 형식을 따르도록 규칙을 정의했습니다.
트리거 조건: API 엔드포인트 작성, 에러 처리 시 자동 적용
bkamp-i18n)"번역은 어떻게 추가해?" "새 언어를 지원하려면?"
8개국어 번역 시스템의 사용법을 정리했습니다.
트리거 조건: 번역, 다언어 지원 작업 시 자동 적용
bkamp-infra)"로컬에서 어떻게 실행해?" "배포는 어떻게 해?"
개발 환경부터 프로덕션 배포까지의 가이드입니다.
트리거 조건: Docker, 배포, DevOps 관련 작업 시 자동 적용
bkamp-review)"내가 짠 코드가 맞는지 확인해줘" "빠진 부분 없어?"
프론트엔드부터 데이터베이스까지 전체 레이어를 검증합니다.
트리거 조건: "검수해줘", "리뷰해줘" 요청 시 자동 적용
bkamp-service-dev)"새 API는 어떻게 만들어?" "데이터베이스 모델은?"
백엔드 개발의 표준 패턴을 정의했습니다.
트리거 조건: 서비스 코드 수정, API 추가 시 자동 적용
Skill은 단순한 마크다운 문서입니다. 복잡한 코드가 아니에요.
markdown--- name: my-skill-name description: 이 Skill이 언제 적용되는지 설명합니다. 특정 작업을 할 때 자동으로 적용됩니다. --- # 제목 여기에 Claude가 알아야 할 내용을 적습니다. ## 규칙 1 - 이렇게 하세요 - 이건 하지 마세요 ## 규칙 2 ...
| 요소 | 설명 | 예시 |
|---|---|---|
name | Skill의 고유 이름 | customer-support-guide |
description | 언제 자동 적용될지 | "고객 문의 처리, 환불 요청 시 자동으로 적용됩니다" |
| 본문 | Claude가 참고할 내용 | 규칙, 절차, 형식 등 |
프로젝트 폴더/ └── .claude/ └── skills/ └── my-skill-name/ └── SKILL.md
비개발자를 위한 Skill 활용 예시 - 예시 1: 고객 지원팀
markdown--- name: customer-support description: 고객 문의 응대, 환불 처리, 불만 접수 관련 작업 시 자동으로 적용됩니다. --- # 고객 지원 가이드 ## 응대 원칙 - 항상 존칭 사용 (고객님) - 24시간 내 첫 응답 - 환불은 7일 이내만 가능 ## 응답 템플릿 ### 일반 문의 "안녕하세요, [고객명]님. [회사명]입니다..." ### 환불 요청 "환불 요청 접수되었습니다. 처리 기간은..."
비개발자를 위한 Skill 활용 예시 - 예시 2: 마케팅팀
markdown--- name: brand-guide description: 마케팅 문구 작성, SNS 포스팅, 보도자료 작성 시 자동으로 적용됩니다. --- # 브랜드 가이드 ## 톤앤매너 - 친근하지만 전문적 - 이모지는 SNS에서만 사용 - "혁신", "최고" 같은 과장 표현 금지 ## 금지어 - ~~업계 최초~~ → "새로운 시도" - ~~완벽한~~ → "신뢰할 수 있는"
비개발자를 위한 Skill 활용 예시 - 예시 3: 재무팀
markdown--- name: expense-report description: 지출 보고서 작성, 경비 정산, 예산 문서 작업 시 자동으로 적용됩니다. --- # 경비 보고서 규칙 ## 필수 항목 1. 날짜 (YYYY-MM-DD 형식) 2. 사용처 3. 금액 (원 단위, 천 단위 콤마) 4. 사용 목적 5. 영수증 첨부 ## 승인 기준 - 10만원 미만: 팀장 승인 - 10만원 이상: 본부장 승인
마무리 - Skill의 마법: "자동 적용"
가장 중요한 건 description에 적힌 조건입니다.
description: 고객 문의 처리, 환불 요청 시 자동으로 적용됩니다.
이렇게 적어두면, 사용자가 "고객 문의에 답변해줘"라고 말할 때 Claude가 자동으로 이 Skill을 참고합니다.
사용자는 Skill의 존재를 몰라도 됩니다. Claude가 알아서 적용합니다.
| 질문 | 답변 |
|---|---|
| Skill이 뭔가요? | Claude에게 회사 규칙을 가르치는 문서예요 |
| 개발자만 쓸 수 있나요? | 아니요, 마크다운만 알면 누구나 가능해요 |
| 매번 적용해야 하나요? | 아니요, 조건에 맞으면 자동 적용돼요 |
| 어디에 저장하나요? | .claude/skills/폴더명/SKILL.md |
.claude/skills/ 폴더 만들기my-guide/)SKILL.md 파일 만들고 내용 작성하기복잡해 보이지만, 결국 **"Claude가 알아야 할 것들을 정리해서 특정 폴더에 저장"**하는 것뿐입니다.
핵심 메시지: Skill은 "Claude의 회사 온보딩 문서"입니다. 신입 사원에게 주는 가이드북처럼, Claude에게 우리 회사만의 규칙을 알려주세요.
댓글을 작성하려면 로그인이 필요합니다.