Claude Code 슬래시 명령과 스킬, 반복 작업을 어떻게 줄였나 - 직접 만들어 쓴 기록

Claude Code 슬래시 명령과 스킬, 반복 작업을 어떻게 줄였나

개발 도구 사용기

공식 문서와 실제 사용 경험을 기준으로 정리했습니다.

Claude Code로 작업하다 보면 "테스트 돌리고 결과 요약해 줘", "이 PR 설명 형식대로 정리해 줘"처럼 거의 같은 지시를 매번 다시 입력하게 되는 순간이 옵니다. 이런 반복을 줄여 준 것이 슬래시 명령(slash command)과 스킬(skill)이었습니다. 이 글은 두 기능이 무엇이고 어떻게 다른지를 공식 문서 기준으로 정리하고, 직접 만들어 쓰며 느낀 점을 덧붙인 기록입니다. 화면이나 명령은 도구 버전에 따라 달라질 수 있으니, 정확한 내용은 본문에 적은 공식 문서를 함께 확인하시길 권합니다.

슬래시 명령이란

슬래시 명령은 입력창에서 /로 시작하는 명령어로, 모델·권한·컨텍스트 같은 동작을 빠르게 제어하는 단축 기능입니다. 명령은 메시지 맨 앞에 와야 하고, 이름 뒤에 적은 텍스트는 인자로 전달됩니다. 기본으로 제공되는 명령만 알아 둬도 손이 한결 가벼워집니다.

• /help — 사용할 수 있는 명령과 도움말을 봅니다.
• /clear — 대화 맥락을 비우고 새 대화를 시작합니다.
• /compact — 길어진 대화를 요약해 컨텍스트 여유를 확보합니다.
• /model — 사용할 모델을 바꿉니다.
• /init·/memory — 프로젝트 규칙 파일(CLAUDE.md)을 만들거나 편집합니다.

여기까지는 "있는 기능을 부르는" 단계입니다. 반복 작업을 본격적으로 줄이려면 그다음, 내가 자주 쓰는 지시를 직접 명령으로 만드는 단계로 넘어갑니다.

나만의 슬래시 명령 만들기

자주 반복하는 지시가 있다면 마크다운 파일 하나로 명령을 만들 수 있습니다. 파일을 두는 위치에 따라 적용 범위가 갈립니다.

• 프로젝트에서만 쓰려면 .claude/commands/ 폴더에 둡니다. 저장소에 함께 커밋하면 팀과 공유됩니다.
• 모든 프로젝트에서 쓰려면 홈 폴더의 ~/.claude/commands/에 둡니다.

파일 이름이 곧 명령 이름이 됩니다. 예를 들어 review.md를 만들면 /review로 부를 수 있습니다. 본문에 적은 내용이 그대로 지시로 전달되고, $ARGUMENTS를 쓰면 명령 뒤에 붙인 값을 받아 쓸 수 있습니다.

# .claude/commands/review.md
---
description: 변경한 코드를 점검 기준에 맞춰 리뷰
argument-hint: [파일 경로]
---

다음 파일을 가독성·버그·예외 처리 관점에서 검토해 주세요: $ARGUMENTS

파일 맨 위 --- 사이의 frontmatter에는 description(명령 설명), argument-hint(인자 힌트), allowed-tools(허용 도구), model(사용할 모델) 같은 설정을 적을 수 있습니다. 생략하면 기본값으로 동작합니다.

스킬(Skills)이란

스킬은 한 걸음 더 나아간 방식입니다. .claude/skills/ 아래에 폴더를 만들고 그 안에 SKILL.md를 두는 구조입니다. 슬래시 명령과 가장 다른 점은 두 가지입니다.

• 본문을 필요할 때만 읽습니다. 평소에는 짧은 설명만 들고 있다가, 그 작업을 할 때 비로소 본문 전체를 불러옵니다. 그래서 길고 자세한 절차서를 만들어 둬도 평소 컨텍스트를 무겁게 하지 않습니다.
• 스스로 골라 쓸 수 있습니다. frontmatter의 description을 보고, 지금 요청에 맞으면 알아서 해당 스킬을 불러옵니다. 물론 /스킬이름으로 직접 부를 수도 있습니다.

구조도 단순합니다. 폴더 안에 SKILL.md를 두고, 필요하면 같은 폴더에 참고 문서나 스크립트 같은 보조 파일을 함께 둘 수 있습니다. 그래서 "절차 + 그 절차에 필요한 자료"를 한 묶음으로 정리하기에 좋습니다.

.claude/skills/
  └─ release-notes/
      ├─ SKILL.md   # name·description + 절차 본문
      └─ template.md  # 함께 쓰는 보조 자료

슬래시 명령과 스킬, 언제 무엇을

둘은 경쟁 관계라기보다 쓰임이 갈립니다. 직접 써 본 기준으로 정리하면 이렇습니다.

상황	추천	이유
짧고 자주 쓰는 지시	슬래시 명령	파일 하나로 간단히 만들고 바로 호출
길고 자세한 절차서	스킬	필요할 때만 본문을 읽어 컨텍스트 절약
상황에 맞춰 알아서 호출	스킬	설명(description)으로 자동 선택
보조 파일이 함께 필요	스킬	같은 폴더에 자료를 묶어 관리

요약하면, 한두 줄 지시를 빠르게 재사용할 때는 슬래시 명령이, 절차가 길거나 상황에 따라 알아서 불러야 할 때는 스킬이 무난했습니다.

실제로 쓰면 좋았던 상황

1리뷰 기준 고정 — 매번 같은 점검 항목을 적는 대신 /review 하나로 통일했더니, 빠뜨리는 항목이 줄었습니다.

2긴 절차의 분리 — 배포 전 점검처럼 단계가 많은 절차를 스킬로 빼 두니, 평소 대화가 그 내용으로 무거워지지 않았습니다.

3팀 공유 — 프로젝트 폴더에 둔 명령을 저장소에 함께 커밋해, 같은 작업을 팀원도 동일한 방식으로 부를 수 있었습니다.

알아 두면 좋은 점

• 한 번 쓰고 말 작업까지 굳이 명령으로 만들 필요는 없습니다. 두 번 이상 반복되는 지시부터 묶는 편이 관리하기 편했습니다.
• 자동 호출되는 스킬은 description을 구체적으로 적을수록 의도한 상황에서 정확히 불립니다. 설명이 막연하면 엉뚱하게 불리거나 아예 안 불릴 수 있습니다.
• 이름이 겹치지 않게 관리하는 편이 좋습니다. 프로젝트용과 개인용을 같은 이름으로 두면 헷갈릴 수 있습니다.

자주 묻는 질문

Q. 슬래시 명령과 스킬의 가장 큰 차이는?

본문을 언제 읽느냐입니다. 슬래시 명령은 부를 때 본문이 그대로 전달되고, 스킬은 필요할 때만 본문을 불러옵니다. 그래서 긴 절차는 스킬이 컨텍스트 면에서 유리합니다.

Q. 만든 명령을 팀과 공유할 수 있나요?

프로젝트의 .claude/commands/나 .claude/skills/에 둔 파일은 저장소에 함께 커밋해 공유할 수 있습니다. 개인용으로만 쓰려면 홈 폴더(~/.claude/)에 두면 됩니다.

Q. 인자를 받는 명령도 만들 수 있나요?

네. 본문에 $ARGUMENTS를 적어 두면 명령 뒤에 붙인 값을 받아 쓸 수 있습니다. 예를 들어 /review src/app.js처럼요.

마무리

슬래시 명령과 스킬은 "새로운 일을 시키는 기능"이라기보다, 이미 자주 하던 일을 매번 다시 설명하지 않게 해 주는 기능에 가깝습니다. 짧고 반복되는 지시는 슬래시 명령으로, 길거나 상황에 맞춰 불려야 하는 절차는 스킬로 나눠 두면 같은 작업을 훨씬 일관되게 처리할 수 있습니다. 처음에는 가장 자주 입력하는 지시 하나를 명령으로 만들어 보는 것부터 권합니다.

이 글의 기능 설명은 Claude Code 공식 문서를 기준으로 정리했습니다. 화면 구성이나 명령은 버전에 따라 달라질 수 있으니, 최신 내용은 공식 문서에서 직접 확인하시길 권합니다.

• 슬래시 명령 문서: code.claude.com/docs/en/slash-commands
• 스킬 문서: code.claude.com/docs/en/skills

※ 본 글은 공개된 공식 문서와 개인적인 사용 경험을 바탕으로 정리한 정보성 콘텐츠입니다. 도구의 기능·화면·명령은 버전에 따라 달라질 수 있으며, 특정 결과를 보장하지 않습니다.