준비
강의 전 현재 폴더, 계정, 설치 상태를 확인합니다.
Phase 55-1
스킬이란? — 슬래시 커맨드의 힘
복잡한 프롬프트를 한 단어로 실행하는 /명령어(슬래시 커맨드)의 개념을 이해하고, 왜 이것이 게임체인저인지 알아봅니다.
Execution Kit
실습 중 막히지 않기 위한 진행표
실행
스킬(슬래시 커맨드)은 복잡한 프롬프트를 한 단어로 실행하는 기능입니다
검증
명령 결과, 파일 변화, 브라우저 화면 중 하나로 성공 여부를 확인합니다.
기록
잘 된 명령과 막힌 지점을 다음 실습을 위한 로그로 남깁니다.
막혔을 때 Claude Code에 붙여넣을 양식
나는 코딩 경험이 많지 않은 실무자입니다. "스킬이란? — 슬래시 커맨드의 힘" 강의를 따라 하고 있습니다.
현재 상태:
- 사용하는 컴퓨터:
- 방금 실행한 명령:
- 화면에 나온 결과 또는 오류:
- 내가 만들고 싶은 업무 결과물:
요청:
1. 지금 상황을 초보자 기준으로 진단해줘.
2. 다음에 실행할 명령을 한 줄씩 제시해줘.
3. 각 명령이 무엇을 하는지 쉬운 말로 설명해줘.
4. 성공 여부를 확인할 체크 포인트를 정리해줘.
5. 실패하면 다시 붙여넣을 오류 보고 양식을 만들어줘.매번 같은 말을 반복하고 계신가요?
> 참고: Phase 4까지는 Claude Desktop 앱과 claude.ai 웹에서의 활용을 다뤘습니다. Phase 5부터는 Claude Code(터미널)를 중심으로 진행합니다. 터미널 기본 명령어는 Phase 2에서 배운 내용을 참고하세요.
Claude를 업무에 활용하다 보면, 비슷한 요청을 반복하게 됩니다.
"이 취업규칙을 검토해줘. 근로기준법 위반 여부를 확인하고, 문제되는 조항은 개선안을 제시해줘. 표 형식으로 정리해줘."
"이 근로계약서를 검토해줘. 필수 기재사항 누락 여부를 확인하고, 불리한 조항은 수정안을 제시해줘."
**기존:** 퇴직금 계산할 때마다 같은 지시를 반복 입력합니다. "평균임금 산정해줘. 최근 3개월 기준으로. 통상임금과 비교해서 유리한 걸로..." 매번 복사-붙여넣기 하거나 처음부터 다시 타이핑합니다.
**AI 활용:** /퇴직금계산 한 번이면 표준화된 계산 프로세스가 바로 실행됩니다.
스킬(슬래시 커맨드)은 이 문제를 해결합니다. 복잡한 프롬프트를 짧은 명령어 하나에 담아두는 것입니다. 노무사 사무실의 표준 업무 매뉴얼을 AI가 자동으로 실행해주는 것이라고 생각하시면 됩니다.
# 스킬 없이 (매번 긴 프롬프트 입력):
"이 취업규칙의 각 조항을 근로기준법, 남녀고용평등법,
기간제법, 파견법 기준으로 검토해줘. 위반 사항은
해당 법조문과 함께 표로 정리하고, 개선안도 제시해줘.
우선순위(상/중/하)도 표시해줘."
# 스킬 사용 후 (한 단어로 실행):
/취업규칙검토
# 이 한 마디로 위의 모든 지시가 자동 실행됩니다!TIP: 스킬은 Claude Code의 가장 강력한 기능 중 하나입니다. '자주 하는 요청'을 스킬로 만들어두면 업무 속도가 비약적으로 빨라집니다.
스킬의 작동 원리
스킬의 원리는 아주 간단합니다.
1. 프로젝트 폴더 안에 .claude/commands/ 라는 폴더를 만듭니다.
2. 그 안에 마크다운(.md) 파일을 만듭니다.
3. 마크다운 파일에 Claude에게 내릴 지시사항을 적어둡니다.
4. 파일 이름이 곧 슬래시 커맨드 이름이 됩니다.
마크다운 파일이 뭔지 모르셔도 됩니다. 메모장에 글 쓰는 것과 같습니다. 제목 앞에 #을 붙이고, 목록은 -로 시작하는 것이 전부입니다.
예를 들어, .claude/commands/취업규칙검토.md 파일을 만들면, Claude Code에서 /취업규칙검토 라고 입력하면 해당 마크다운 파일의 내용이 자동으로 프롬프트에 삽입됩니다.
최근에는 .claude/skills/ 폴더를 통한 Skills 시스템도 추가되었습니다. Skills는 YAML 프론트매터를 지원하여 이름, 설명, 트리거 조건 등을 정의할 수 있습니다. .claude/skills/퇴직금계산/SKILL.md 처럼 폴더 안에 SKILL.md 파일을 만들면 됩니다.
쉽게 말해, "미리 작성해둔 상세 지시서를 한 단어로 불러오는 것"입니다. 노무사 사무실에 비유하면, 신입 직원에게 주는 업무 체크리스트를 파일로 만들어둔 것과 같습니다.
# 커스텀 스킬(명령어) 폴더 만들기 (터미널에서 입력):
mkdir -p .claude/commands
# 스킬 파일 만들기 예시:
cat > .claude/commands/취업규칙검토.md << 'EOF'
이 파일을 읽고 다음을 검토하세요:
1. 근로기준법 위반 조항
2. 남녀고용평등법 위반 조항
3. 모호한 표현
EOF
# Claude Code에서 사용:
claude
> /취업규칙검토 취업규칙_A병원.txt
# 스킬의 구조 (폴더 구성):
# 프로젝트폴더/
# ├── .claude/
# │ ├── commands/ ← 슬래시 커맨드 (기본)
# │ │ ├── 취업규칙검토.md → /취업규칙검토
# │ │ ├── 근로계약서분석.md → /근로계약서분석
# │ │ ├── 임금계산.md → /임금계산
# │ │ └── 판례분석.md → /판례분석
# │ └── skills/ ← Skills 시스템 (확장)
# │ └── 퇴직금정산/
# │ └── SKILL.md → YAML 프론트매터 + 지시사항
# ├── CLAUDE.md
# └── (기타 프로젝트 파일들)왜 스킬이 게임체인저인가?
스킬이 단순한 '복사-붙여넣기 단축키'가 아닌 이유가 있습니다.
1. 전문성의 축적: 최고의 프롬프트를 한 번 만들어두면, 매번 같은 품질의 결과를 얻습니다. 한 번 좋은 프롬프트를 만들 때의 노력이 계속 재활용됩니다. 19년차 노무사의 노하우를 스킬 파일에 녹여넣는 것입니다.
2. 팀 공유: 사무실 내 다른 노무사나 직원에게 스킬 파일만 공유하면, 같은 수준의 AI 활용이 가능합니다. "이렇게 이렇게 물어봐"라고 가르칠 필요가 없습니다. 경력 노무사의 검토 기준이 그대로 신입 직원에게 전달됩니다.
3. 품질 표준화: 같은 스킬을 사용하면 누가 실행해도 같은 형식, 같은 체크포인트로 결과가 나옵니다. 취업규칙 검토 때 빠뜨리기 쉬운 항목(예: 육아휴직 규정, 괴롭힘 금지 규정)도 스킬에 넣어두면 절대 놓치지 않습니다.
4. 파이프라인 구축: 여러 스킬을 연결하면 '사건접수 → 분석 → 문서작성 → 검수'까지 자동화된 워크플로우를 만들 수 있습니다. (5-4에서 다룹니다)
**비유:** 스킬은 노무사 사무실의 업무 매뉴얼을 디지털화한 것입니다. 신입 노무사에게 "이 순서대로 검토해"라고 주는 체크리스트를, AI에게 주는 것뿐입니다.
TIP: 사무실에서 가장 자주 하는 업무 3가지를 떠올려보세요. 그것이 첫 번째로 만들 스킬 후보입니다.
내장 스킬 살펴보기
Claude Code에는 이미 만들어져 있는 내장 명령어(빌트인 커맨드)가 있습니다. 다음 강의(5-2)에서 상세히 다루겠지만, 대표적인 것들을 미리 살펴봅시다.
- /help: Claude Code 사용법 안내
- /commit: 코드 변경사항을 Git에 저장 (내장 명령어)
- /review-pr: Pull Request 코드 리뷰 (내장 명령어)
이런 내장 명령어 외에, 우리가 직접 만드는 커스텀 스킬(.claude/commands/ 또는 .claude/skills/)이 노무사 업무의 핵심입니다. 5-3 강의에서 본격적으로 만들어봅니다.
# Claude Code 시작 (터미널에서 입력):
claude
# Claude Code 안에서 내장 명령어 사용:
> /help # 사용 가능한 명령어 목록 확인
> /commit # 변경사항 저장 (Git 커밋)
> /review-pr # Pull Request 리뷰
> /clear # 대화 내역 초기화
# Shift+Tab: 모드 전환 (plan/auto/normal)
# Ctrl+C: 현재 작업 중단핵심 정리
- ✓스킬(슬래시 커맨드)은 복잡한 프롬프트를 한 단어로 실행하는 기능입니다
- ✓.claude/commands/ 또는 .claude/skills/ 폴더에 마크다운 파일로 스킬을 만듭니다
- ✓파일 이름이 곧 /명령어 이름이 됩니다
- ✓스킬은 전문성 축적, 팀 공유, 품질 표준화를 가능하게 합니다