Claude 스킬 심화: 있을 때와 없을 때 어떻게 다른가

이것은 Claude Skills에 대한 실용적이고 깊이 있는 가이드입니다. Skills가 무엇인지, 어떻게 추가하는지, 어떤 것을 설치해야 하는지, 그리고 직접 작성하는 방법까지 다룹니다. 그리고 그 차이는 보는 것이 가장 쉽기 때문에, 이 가이드는 그림을 중심으로 구성되어 있습니다. Skill이 없을 때와 있을 때 실제 작업이 어떻게 보이는지를 보여줍니다.

이 글은 쉬운 언어로 쓰여졌으며, 직접 볼 수 있는 실제 예제, Skills가 내부에서 어떻게 작동하는지에 대한 더 자세한 설명, 그리고 팀 전체에 도입하기 위한 실용적인 경로를 담고 있습니다. 단 한 섹션만 읽는다면, 아래의 세 가지 전후 비교 예제를 읽으세요.

한 줄짜리 아이디어

Claude는 뛰어난 만능 일꾼입니다. 스킬은 그것을 한 가지 일을, 당신의 방식대로 하는 전문가로 만듭니다 — 그리고 기억합니다. 지침을 한 번 작성해 작은 폴더로 건네면, 그때부터 Claude는 그 작업을 매번 같은 방식으로 합니다. 다시 설명할 필요도, 메모 앱에 보관해 둔 프롬프트를 복사해 붙일 필요도 없습니다.

그 차이는 눈으로 보는 것이 가장 쉽습니다. 같은 요청을, 먼저 스킬 없이, 그다음 알맞은 스킬을 설치한 채 답한 결과가 여기 있습니다.

예시 1 — 문서 만들기

이사회 보고서를 요청합니다. 문서 스킬이 없으면 Claude는 밋밋한 텍스트로 최선을 다합니다. pdf 스킬이 설치되어 있으면 실제 파일을 만들어 냅니다 — 표지, 브랜드 바, 차트, 깔끔한 표, 푸터가 달린 페이지까지.

요청은 전혀 바뀌지 않았습니다. 유일한 차이는 한 버전이 진짜 PDF를 만드는 법을 안다는 것입니다 — 누군가 한 번 가르쳐 줬기 때문입니다. docx, xlsx, pptx도 마찬가지입니다 — 변경 내용 추적이 되는 Word 문서, 피벗과 차트가 든 Excel 모델, 브랜드가 입혀진 슬라이드 덱.

예시 2 — SQL 검토

일반적인 Claude는 쿼리가 “괜찮아 보인다”고 흔쾌히 말해 줍니다. 당신의 스키마를 아는 스킬은 훨씬 유용한 일을 합니다: 쿼리를 당신의 테이블과 인덱스에 대조해 검사하고, 프로덕션에서 무엇이 느려질지 표시하고, 다시 작성해 줍니다.

SELECT o.id, o.total
FROM orders o
WHERE o.customer_id = $1
  AND o.created_at >= now() - interval '30 days';

이것은 다른 누구도 당신을 위해 출판할 수 없는 스킬입니다 — 당신의 데이터베이스에 달려 있기 때문입니다. 바로 그 점이 이것이 그토록 가치 있는 이유이고 — 또한, 곧 보겠지만, 그토록 만들기 쉬운 이유입니다.

예시 3 — 안전한 방식으로 코드 작성하기

새 기능을 요청하면 Claude는 코드를 작성합니다. test-driven-development 스킬을 켜고 요청하면 작업 순서가 바뀝니다: 실패하는 테스트를 먼저, 그다음 통과에 딱 필요한 만큼의 코드, 그리고 정리. 엣지 케이스는 배포 후가 아니라 이전에 잡힙니다.

이것이 스킬의 핵심을 한 장의 그림에 담은 것입니다: 더 똑똑한 모델이 아니라, 절제된 모델 — 신중한 동료에게 바랄 법한 방식을 따르는 모델입니다.

가장 새로운 스킬들 — Claude가 당신 없이 일할 때

위의 세 예시는 품질에 관한 것입니다: 같은 작업을 제대로 하는 것. Claude Code에 가장 최근 추가된 것들은 다른 것에 관한 것입니다 — 시간입니다. 이들은 Claude가 당신의 차례 사이에, 일정에 따라, 혹은 한 무리의 에이전트로 동시에 계속 일하게 합니다. 이것들은 설치하는 파일이 아니라 Claude Code에 내장된 슬래시 명령으로 제공되지만, 아이디어는 같습니다: 일을 건네고, 당신의 방식대로 끝내는 것. 알아 둘 가치가 있는 세 가지를, 각각 전후 비교로 소개합니다.

/loop — 긴 작업을 돌보지 않기

사람들이 가장 많이 묻는 것입니다. 배포, CI 실행, 느린 빌드 — 평소라면 앉아서 다시 확인할 무엇이든. /loop를 쓰면 Claude가 그 재확인을 대신해 주는데, 영리한 부분은 스스로 속도를 조절하는 방식입니다.

두 가지 모드가 있습니다. 간격을 주면 — /loop 5m check the deploy — 고정된 주기로 실행됩니다. 간격을 빼면 — /loop check whether CI passed and fix any review comments — Claude가 각 패스 후 대기 시간을 스스로 정합니다: 빌드가 활발할 땐 짧게, 조용해지면 길게, 그리고 작업이 명백히 끝나면 스스로 루프를 종료할 수 있습니다. 아무것도 붙이지 않은 /loop는 내장된 “브랜치 돌보기” 유지보수 프롬프트를, 혹은 당신이 작성했다면 당신만의 .claude/loop.md를 실행합니다. 루프는 세션 범위이며 7일 후 만료되므로, 잊힌 루프가 영원히 돌아갈 수는 없습니다.

/schedule — 노트북 없이 실행되는 작업

/loop는 세션이 열려 있어야 합니다. 루틴은 그렇지 않습니다. 작업을 한 번 정의하면 — 프롬프트, 건드릴 수 있는 저장소, 필요한 커넥터 — 그것이 Anthropic의 클라우드에서 일정에 따라, GitHub 이벤트(PR 열림, 릴리스 발행)에 따라, 혹은 당신만의 웹훅에 따라 실행됩니다. 당신의 머신은 꺼져 있어도 됩니다.

맞교환은 단순합니다: /loop는 세션 도중의 빠른 폴링용이며 로컬 파일을 볼 수 있고; 루틴은 당신이 책상에 있든 없든 확실하게 일어나야 하는 작업용이며 클라우드의 새로운 클론에서 실행됩니다. 주간 의존성 점검, 아침 이슈 분류, 병합 후 검토 — 한 번 설정해 두고 잊으세요.

/code-review ultra — 지친 독자 하나가 아니라, 검토 팀 전체

보통의 검토는 한 번의 패스입니다. Ultra 검토는 당신의 브랜치를 클라우드의 에이전트 함대로 보내 각기 다른 각도에서 병렬로 검토하게 한 뒤, 모든 발견을 반증하려 시도하는 적대적 패스를 실행합니다 — 그래서 거짓 경보는 버려지고 진짜 버그만 당신에게 도달합니다.

이것은 중량급 옵션입니다: 더 느리고 추가 사용량으로 청구되므로, 모든 사소한 변경이 아니라 위험한 병합 전에 꺼내 듭니다. 일상적인 diff에는 더 가벼운 /code-review로 충분합니다. ultra는 판돈이 클 때 불러들이는 두 번째 의견이라고 생각하세요.

그림 없이도 언급할 가치가 있는 더 새로운 구성 요소 두 가지가 있습니다. 서브 에이전트는 Claude가 큰 작업을 병렬로 일하는 여러 에이전트에게 펼쳐 내게 합니다 — 하나가 데이터베이스 계층을 읽는 동안 다른 하나가 API를 읽고 — 그런 다음 답을 모읍니다. 그리고 영속 메모리는 Claude가 세션을 가로질러 메모를 유지하게 하여, 매일 아침 프로젝트를 다시 설명하지 않게 합니다. /loop, 루틴과 함께 방향은 분명합니다: 당신이 Claude를 기다리는 일은 줄고, Claude가 일하는 동안 당신은 다른 일을 하는 쪽으로.

스킬이란 실제로 무엇인가

속을 들여다보면 스킬은 시원하리만치 단순합니다: 필수 파일 하나, SKILL.md를 담은 폴더입니다. 그 파일에는 이름, 설명, 지침이 있습니다. 선택적으로 스크립트와 참조 파일을 함께 묶을 수 있습니다.

---
name: sql-reviewer
description: Review and optimise SQL against our schema and conventions.
  Use when the user writes, reviews, or tunes SQL queries.
---

# SQL reviewer

When given a query, check it against db/schema.sql, flag full table
scans, suggest indexes, and rewrite to our house style...

영리한 부분은 Claude가 그것을 어떻게 쓰느냐입니다. Claude는 설치된 모든 스킬의 이름과 설명을 항상 봅니다 — 그건 값싸고, 각각 한 문장일 뿐입니다. 하지만 요청이 설명과 들어맞을 때만 전체 지침을 불러옵니다. 그래서 수십 개의 스킬을 설치해 두고도 특정 작업이 실제로 필요로 하는 한두 개에만 (컨텍스트와 주의력 면에서) “비용”을 치릅니다. 그래서 설명이 그토록 중요합니다: 그것이 방아쇠입니다. 모호한 설명은 스킬이 결코 발동하지 않게 만들고; 날카로운 설명(“Use when the user writes, reviews, or tunes SQL”)은 정확히 알맞은 순간에 발동하게 합니다.

스킬 추가하기 — 작동하는 모든 방법

웹에서 (claude.ai)

Settings → Capabilities로 가서 “Code execution and file creation.”을 켜세요. 그런 다음 Customize → Skills를 엽니다. 거기서 기본 제공 스킬(문서 관련 스킬들이 여기 있습니다)을 켜거나, “+” → “Create skill” → “Upload a skill”을 클릭해 직접 만든 스킬을 ZIP으로 올릴 수 있습니다. Free, Pro, Max, Team, Enterprise 요금제에서 작동합니다.

Claude Code에서 (터미널)

두 가지 경로가 있습니다. 첫째는 그냥 파일입니다 — 폴더를 제자리에 두세요:

# personal, available everywhere
~/.claude/skills/<name>/SKILL.md

# project-local, shared with your team through Git
.claude/skills/<name>/SKILL.md

둘째는 마켓플레이스로, 좋은 커뮤니티 스킬이 사는 곳입니다. 마켓플레이스를 한 번 추가한 뒤, 앱처럼 스킬을 설치합니다:

# add a marketplace, then install from it
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills

# or clone any skill repo straight into your skills folder
git clone https://github.com/owner/skill-name ~/.claude/skills/skill-name

프로젝트 로컬 스킬(.claude/skills/ 경로)은 팀을 위한 조용한 영웅입니다: 저장소에 커밋하면 모든 팀원이 — 그리고 모든 CI 실행이 — 별도 설정 없이 같은 스킬을 자동으로 얻습니다.

실제로 설치할 가치가 있는 스킬

하는 일별로 묶었습니다. 출처와 설치 줄은 다음 섹션에 이어집니다.

문서와 데이터

• pdf, docx, xlsx, pptx (anthropics/skills) — 예시 1의 문서 일꾼들. 브랜드가 입혀진 덱을 만들고, 피벗과 차트가 든 Excel 모델을 생성하고, 변경 내용 추적이 되는 Word 문서를 편집하고, PDF에서 텍스트와 표를 뽑아냅니다. 설치: /plugin install document-skills@anthropic-agent-skills.
• csv-processing — CSV 파일을 파싱하고, 정리하고, 검증하고, 분석합니다. 일상적인 데이터 가공 스킬입니다.
• SQL — 직접 만드세요 (예시 2). 당신의 스키마, 네이밍, 쿼리 관례를 아는 스킬이 어떤 일반적인 것보다 낫습니다. 아래에서 그 방법을 보여 드립니다.

코드 품질과 QA

• test-driven-development (obra/superpowers) — 예시 3의 RED → GREEN → REFACTOR 절제. 흔들리지 않는 비동기 테스트를 위해 testing-anti-patterns, condition-based-waiting과 짝을 이룹니다.
• systematic-debugging (superpowers) — 추측과 확인 대신 4단계 근본 원인 분석법, 그리고 수정이 실제로 작동함을 증명하는 verification-before-completion까지.
• webapp-testing (anthropics/skills) — Playwright로 실제 브라우저를 구동해 당신의 UI가 작동하는지 검증합니다.
• requesting-code-review / receiving-code-review (superpowers) — 심각도 태그가 붙은 발견 항목이 담긴 사전 검토 체크리스트, 그리고 피드백을 차분하게 다시 녹여 내는 방법.

만들기 전에 생각하기 (“그릴”)

• brainstorming (superpowers) — 코드 한 줄을 쓰기 전에 당신의 계획을 어려운 질문으로 캐묻는 소크라테스식 그릴링. 나쁜 아이디어를 죽이는 가장 값싼 방법입니다.
• writing-plans (superpowers) — 정확한 파일 경로와 함께 작업을 작고 검증 가능한 단위로 쪼개어, 실행이 가장 좋은 의미로 지루해지게 합니다.
• request-refactor-plan — 겁나는 리팩터링을 한 번의 위험한 도약 대신 작고 안전한 일련의 커밋으로 바꿉니다.

글쓰기와 커뮤니케이션

• writing-fragments → writing-shape → writing-beats — 어지러운 메모 더미에서 다듬어진 초안으로, 다시 완성된 글로, 한 번에 하나의 결정씩 이끌어 주는 묶음입니다. 글과 제안서에 정말 좋습니다.
• brand-guidelines (anthropics/skills) — 모든 문서와 메시지를 브랜드에 맞게 유지합니다: 당신의 목소리, 당신의 규칙.
• internal-comms — 메모, 공지, 업데이트를 일관된 톤으로 작성합니다.

Git, 배포, 도구 연결

• using-git-worktrees와 finishing-a-development-branch (superpowers) — 여러 브랜치를 자리를 잃지 않고 병렬로 작업한 뒤, 깔끔하게 병합/PR 결정을 내립니다.
• commit & PR 헬퍼 (공식 마켓플레이스) — 팀 전체에 걸쳐 일관된 커밋 메시지와 풀 리퀘스트.
• mcp-builder (anthropics/skills) — Claude가 당신의 시스템과 데이터에 닿을 수 있도록 커넥터를 만듭니다. 이미 운영 중인 도구에 Claude를 연결하는 방법입니다.

어디서 찾는가

• github.com/anthropics/skills — Anthropic의 공식 모음(문서 스킬, webapp-testing, mcp-builder, brand-guidelines, canvas-design 등)과 직접 만들 수 있는 템플릿. /plugin marketplace add anthropics/skills로 추가하세요.
• obra/superpowers — 가장 사랑받는 커뮤니티 라이브러리: TDD, 디버깅, 브레인스토밍, 계획 수립, 코드 검토, git 워크플로. /plugin install superpowers@claude-plugins-official(또는 /plugin marketplace add obra/superpowers-marketplace)로 설치하세요.
• claude.com/plugins — 공식 마켓플레이스로, Claude Code 안에서 /plugin으로 둘러볼 수 있습니다. GitHub, Stripe, Figma 같은 팀들의 커넥터와 툴킷이 있습니다.
• “awesome-claude-skills” 목록 — 수백 개의 스킬을 카테고리별로 정리한 커뮤니티 디렉터리. karanb192/awesome-claude-skills와 ComposioHQ/awesome-claude-skills가 좋은 출발점입니다.

10분 만에 직접 작성하기

가장 가치 있는 스킬은 오직 당신만이 쓸 수 있는 것입니다. 예시 2의 SQL 리뷰어를 만드는 전체 레시피가 여기 있습니다:

1. 폴더를 만드세요: ~/.claude/skills/sql-reviewer/.
2. 그 안에 schema.sql을 넣어 Claude가 당신의 실제 테이블을 볼 수 있게 하세요.
3. 날카로운 설명과 당신의 하우스 룰이 담긴 SKILL.md를 추가하세요(앞의 스니펫이 완전한 출발점입니다).
4. Claude에게 쿼리를 검토해 달라고 하세요. 설명이 들어맞고, 스킬이 불러와지며, 예시 2의 결과를 얻습니다.

그것이 전체 흐름입니다. 어려운 부분은 형식이 아니라 — “당신의 방식”이 실제로 무엇을 뜻하는지 정하고, 한 번 적어 두고, 다시는 설명하지 않는 것입니다.

무엇이든 설치하기 전 한 가지 규칙

스킬은 당신의 머신에서 코드를 실행할 수 있으므로, 스킬 설치를 소프트웨어 설치와 똑같이 다루세요: 직접 작성했거나 신뢰하는 출처에서 온 스킬을 우선하고, SKILL.md를 먼저 읽으세요. 2분의 독서는 당신이 요청하지 않은 일을 조용히 저지르는 스킬에 대한 값싼 보험입니다. 팀의 경우, 프로젝트 로컬 .claude/skills/ 폴더에 일반적인 코드 검토를 더하는 것이 가장 안전한 모델입니다 — 스킬도 당신이 배포하는 다른 어떤 코드와 같은 검증을 받습니다.

핵심 요점

위의 세 그림을 다시 보세요. 모든 경우에 모델은 같고 요청도 같습니다 — 오직 절제만 바뀌었습니다. 그것이 스킬입니다: Claude에게 당신의 기준을 한 번 건네고 매번 적용되게 하는 방법. 위 목록에서 몇 개를 설치해 차이를 느낀 뒤, 다른 누구도 당신을 위해 출판할 수 없는 그 스킬을 작성하세요 — 당신의 스키마, 당신의 브랜드, 당신의 배포 방식을 아는 그 스킬 말입니다. 그때 Claude는 영리한 만능 일꾼이기를 멈추고 진정으로 당신의 것이 됩니다.