SKILL 핵심 파악하기

얻어갈 것

• Skill을 "반복 지시를 저장한 작업 방식"으로 이해합니다.
• Skill과 그냥 긴 프롬프트를 매번 붙여 넣는 방식의 차이를 구분합니다.

Skill은 작업 방식의 즐겨찾기

• Skill은 잘 되던 지시와 작업 순서를 문서 한 장으로 저장해 둔 것입니다.
• 매번 긴 설명을 다시 쓰는 대신, 직접 Skill을 호출하거나 에이전트가 맥락에 맞춰 자동으로 꺼내 쓰게 할 수 있습니다.
• 단순한 프롬프트 저장소라기보다, "이런 상황에서는 이런 순서로 일해줘"를 정리한 작업 레시피에 가깝습니다.

확대

Skill 활용 사례

Skill은 개발 작업에만 쓰는 기능이 아닙니다. 반복되는 입력, 판단 기준, 결과물 형식이 있으면 대부분 후보가 됩니다.

• 강의·콘텐츠 정리: 메모나 녹취를 받아 얻어갈 것 → 본문 → 실습 프롬프트 → 마무리 형식으로 다듬기.
• 회의 후속 처리: 회의록에서 결정 사항, 담당자, 마감일만 뽑고 후속 메일 초안까지 만들기.
• 브라우저 점검: 로컬 사이트를 열고 핵심 화면, 버튼, 폼, 모바일 화면을 확인한 뒤 재현 경로와 스크린샷을 남기기.
• 리서치 요약: 여러 링크를 읽고 주장, 근거, 반대 의견, 출처를 같은 표로 정리하기.
• 데이터 점검: CSV에서 누락값, 중복 행, 이상한 값을 찾고 사람이 볼 요약 리포트로 바꾸기.
• 개발 루틴: PR 리뷰, 테스트 실패 원인 분리, 배포 전 체크처럼 매번 확인 기준이 비슷한 일을 맡기기.

이렇게 보면 Skill 후보는 "전문적인 개발 자동화"보다 "내가 매번 비슷하게 설명하는 일"에서 먼저 나옵니다.

좋은 Skill은 "매번 똑같이 설명하기 귀찮은 일"에서 시작합니다. 한 번만 쓸 요청이라면 굳이 Skill로 만들 필요는 없습니다.

Skill 파일 들여다보기

• Skill은 SKILL.md 파일 하나에서 시작합니다.
• 위쪽의 YAML frontmatter는 "언제, 어떻게 불러올지"를 정하고, 아래쪽 markdown 본문은 "불러온 뒤 어떤 순서로 일할지"를 정합니다.
• 가장 중요한 metadata는 description입니다. Claude가 이 설명을 보고 자동으로 Skill을 쓸지 판단합니다.

Claude Code에서 자주 보게 될 metadata는 이 정도만 먼저 알아 두면 됩니다.

• name: Skill 목록에 보이는 표시 이름입니다. 실제 /명령어 이름은 보통 폴더 이름에서 옵니다.
• description: 이 Skill이 무엇을 하고 언제 쓰이는지 설명합니다.
• argument-hint: /skill-name ...을 입력할 때 어떤 인자를 넣어야 하는지 힌트를 보여줍니다.
• disable-model-invocation: true로 두면 Claude가 자동으로 꺼내 쓰지 않고, 사용자가 직접 호출할 때만 씁니다.

더 자세한 metadata는 Claude Code Skill 문서를 보면 됩니다: Claude Code Skills

---
name: check-browser
description: 로컬 웹앱을 브라우저에서 열고 핵심 화면을 점검합니다. 사용자가 배포 전 확인, UI 점검, 화면 QA를 요청할 때 씁니다.
argument-hint: "[URL]"
---

# 브라우저 점검

1. 사용자가 준 URL을 브라우저로 엽니다.
2. 홈, 주요 목록, 상세 화면처럼 핵심 경로를 순서대로 방문합니다.
3. 버튼, 폼, 모바일 화면에서 깨지는 부분이 있는지 확인합니다.
4. 문제를 발견하면 재현 경로, 기대 동작, 실제 동작, 스크린샷 필요 여부를 짧게 보고합니다.

이 예시는 Skill의 구조를 보여줍니다. description은 호출 조건이고, 본문은 작업 순서입니다.

범위와 스킬 범위

확대

Skill은 어디에 두느냐에 따라 적용 범위가 달라집니다.

• Personal Skill: ~/.claude/skills/<skill-name>/SKILL.md에 둡니다. 내 모든 프로젝트에서 쓰는 개인 작업 방식입니다.
• Project Skill: .claude/skills/<skill-name>/SKILL.md에 둡니다. 해당 프로젝트 안에서 팀과 공유하는 작업 방식입니다.
• Plugin Skill: 플러그인 안에 포함된 Skill입니다. 플러그인을 설치하고 활성화한 곳에서 사용할 수 있습니다.

남의 스킬 설치하기

남이 만든 Skill은 skills.sh에서 주로 찾아볼 수 있습니다. Skills CLI를 쓰면 보통 이런 식으로 설치합니다.

npx skills add <owner/repo>

find-skills는 먼저 설치해 두기 좋은 Skill입니다. "이런 작업에 맞는 Skill이 있나?"를 물어보면 skills.sh 생태계에서 후보를 찾아주고, 설치 명령까지 같이 제안해줍니다.

npx skills add https://github.com/vercel-labs/skills --skill find-skills

주의할 점: 막 그대로 가져다 쓰면 안 됩니다

• 내 프로젝트 파일을 마음대로 고치라고 되어 있지 않은지 봅니다.
• 외부 명령, API 키, 비밀 파일을 다루는 지시가 있는지 봅니다.
• 내가 원하는 작업 방식과 맞지 않으면 그대로 쓰지 말고 수정해서 씁니다.

직접 만들기보다 먼저 반복을 찾기

• 처음부터 Skill을 만들려고 하지 말고, 자연어로 몇 번 시켜 보며 잘 되는 흐름을 찾습니다.
• 같은 작업을 세 번 이상 비슷하게 시킨다면 Skill 후보로 봅니다.
• 잘 끝난 작업 뒤에 "방금 한 흐름을 Skill로 만들어줘"라고 요청하는 편이 초보자에게 가장 쉽습니다.

실습하기: 회의록 정리 Skill 초안 만들기

앞 레슨에서 meetings를 결정 사항, 할 일, 미정 사항으로 나눠 봤습니다. 이번에는 그 정리 방식을 매번 다시 설명하지 않아도 되도록 Skill을 만들어 봅시다.

@meetings 를 기준으로, 회의록 정리 방식을 Skill 초안으로 만들어줘.

목적은 회의록을 읽고 아래 세 가지로 정리하는 거야.
- 결정된 것
- 해야 할 일
- 아직 정해지지 않은 것

실제 SKILL 파일 만들기 전에 초안 나한테 검토받아

마무리

• Skill은 에이전트에게 "이번에는 이런 방식으로 일해줘"라고 기억시키는 장치입니다.
• 처음부터 완벽한 Skill을 만들려고 하기보다, 잘 된 대화 흐름을 작은 문서로 옮기는 것부터 시작하면 됩니다.
• 다음 레슨에서는 Skill이 작업 방식이라면, 외부 도구 자체를 붙이는 MCP가 무엇인지 봅니다.