Jeongsk

index

6 min read

Claude Code 문서 모음

Claude Code 사용 방법과 Agent Skills에 대한 한글 가이드 문서 모음입니다.

📚 주요 문서

Agent Skills (Claude의 기능 확장)

Agent Skills는 Claude가 자동으로 필요한 시점에 활성화하는 기능입니다. 반복되는 워크플로우를 자동화하고 팀 규칙을 공유할 수 있습니다.

  1. Agent Skills - 시작하기 ⭐ 초보자용

    • 5분 안에 첫 Skill 만들기
    • 단계별 실습 가이드
    • 커밋 메시지 생성 Skill 예제

  2. Agent Skills - Claude Code Docs 📖 완전한 레퍼런스

    • 전체 기능 설명
    • Personal/Project Skill의 차이
    • Skill 디버깅 및 모범 사례
    • SKILL.md 작성법 상세 가이드

  3. Agent Skills - 고급 활용 🚀 심화 학습

    • 스크립트와 템플릿 포함 Skill
    • PDF 처리 실전 예제 (pdfplumber, pypdf)
    • 데이터 분석 Skill
    • Git 워크플로우 자동화

🎯 빠른 시작

1단계: 개념 이해

Agent Skills - Claude Code Docs에서 기본 개념 읽기

2단계: 첫 Skill 만들기

Agent Skills - 시작하기를 따라 5분 안에 커밋 메시지 Skill 생성

3단계: 팀과 공유

Project Skill로 변환해서 팀원들과 공유

4단계: 고도화

Agent Skills - 고급 활용을 참고해서 스크립트와 자동화 추가

🔍 찾고 있는 내용별

찾는 것문서섹션
Skill 처음 배우기시작하기전체
SKILL.md 작성법Claude Code DocsSKILL.md 작성
Description 잘 쓰는 법Claude Code Docsname/description 필드 설명
Skill이 작동 안 할 때Claude Code DocsSkill 디버깅
팀과 공유하기Claude Code Docs팀과 Skills 공유
스크립트 포함 Skill고급 활용실전 예제 1: PDF 처리
디버그 팁Claude Code Docs🔍 디버그 팁
모범 사례Claude Code Docs모범 사례

📝 주요 개념

Skill vs Command

  • Skill: Claude가 필요를 자동으로 감지하고 사용
  • Command: 사용자가 /command 입력해서 명시적으로 호출

Personal vs Project Skill

  • Personal: ~/.claude/skills/ - 개인용, git 미추적
  • Project: .claude/skills/ - 팀 공유, git 추적

Description의 중요성

Claude가 Skill을 사용할지 결정하는 기준입니다.

✅ 좋은 설명:

“Extract text and tables from PDF files, merge multiple PDFs, fill PDF forms. Use when working with PDF files, extracting content, combining documents, or completing forms.”

❌ 나쁜 설명:

“Helps with documents”

🚀 실전 예제

커밋 메시지 자동 생성

name: commit-message-helper
description: Generate clear commit messages. Use when writing commits or reviewing staged changes.

PDF 처리

name: pdf-processor
description: Extract text from PDFs, merge documents, fill forms. Use when working with PDF files.

코드 리뷰

name: code-reviewer
description: Review code for best practices and issues. Use when reviewing code or checking PRs.
allowed-tools: Read, Grep, Glob

⚠️ 자주 하는 실수

  1. Description이 너무 모호함

    • ❌ “Helps with data”
    • ✅ “Analyze Excel spreadsheets, create pivot tables”

  2. YAML 문법 오류

    • 탭 대신 공백 사용
    • 콜론 뒤에 공백 필수

  3. 파일 위치 틀림

    • Personal: ~/.claude/skills/skill-name/SKILL.md
    • Project: .claude/skills/skill-name/SKILL.md

📚 유용한 링크

공식 문서

Claude Code 베스트 프랙티스 & 튜토리얼

Agent SDK & 예제

Skills 리소스

커뮤니티 가이드

추가 학습 자료

4건의 항목