3 minute read

개요

이 문서는 필요할 때마다 ‘꺼내 먹으면’ 에이전트처럼 쓸 수 있는 클로드 스킬 (강수진 박사) 유튜브 영상을 참고하여 Claude Skill의 핵심 개념과 활용법을 정리함.

“클로드 스킬(Claude Skill)”은 마치 RPG 게임에서 캐릭터가 상황에 맞는 스킬을 골라 쓰는 것처럼, AI에게 특정 전문 지식이나 작업 매뉴얼을 모듈(Module) 형태로 장착시켜 필요할 때마다 꺼내 쓸 수 있게 하는 개념임.

Claude RPG Skill Concept

핵심 개념 (Core Concepts)

1. “꺼내 먹는” 에이전트 (On-Demand Agent Capabilities)

  • 비유: 거대한 만능 주머니에서 도구를 꺼내는 것과 같음. 모든 도구를 한꺼번에 손에 쥐고 있는 것이 아니라, 못을 박아야 할 때는 망치를, 나무를 자를 때는 톱을 꺼내 씀.
  • 작동 원리: 클로드에게 모든 지시사항(Prompt)을 한 번에 입력하는 대신, 작업의 종류(글쓰기, 코딩, 데이터 분석 등)에 따라 미리 정의된 스킬 파일을 로드하여 사용함.

2. 점진적 공개 (Progressive Disclosure)

  • 효율성: AI의 컨텍스트 윈도우(기억 용량)는 제한적이고, 너무 많은 정보는 오히려 성능을 저하시킬 수 있음.
  • 최적화: 스킬 시스템을 통해 “필요한 순간에 필요한 정보만” 제공함으로써, 토큰 비용을 절약하고 AI의 집중력을 높일 수 있음.

3. 모듈형 지식 (Modular Knowledge)

  • 복잡한 업무를 작은 단위의 스킬(.md 파일)로 분리하여 관리함.
    • email_writer_skill.md: 비즈니스 이메일 작성 전문가
    • code_reviewer_skill.md: 파이썬 코드 리팩토링 전문가
    • meeting_summarizer_skill.md: 회의록 요약 전문가

활용 예시 (Use Cases)

상황 1: 복잡한 코딩 프로젝트

  1. 기획 단계: architect_skill.md를 불러와 전체 구조를 설계함.
  2. 구현 단계: frontend_skill.md와 backend_skill.md를 번갈아 호출하며 코드 작성.
  3. 검수 단계: security_check_skill.md를 사용하여 취약점 점검.

상황 2: 콘텐츠 제작

  1. 초안 작성: blog_post_skill.md를 사용하여 주제를 구조화함.
  2. 교정: editor_skill.md를 사용하여 맞춤법 및 문체 수정.
  3. 이미지 생성: image_gen_prompt_skill.md를 사용하여 삽화 프롬프트 생성.

결론

강수진 박사의 설명처럼, Claude Skill은 AI를 단순한 챗봇이 아닌 전문가 팀으로 활용할 수 있게 해주는 열쇠임. 나만의 업무 노하우를 스킬 파일로 정리해두면, 언제든 나를 대신해 완벽하게 업무를 처리해주는AI 비서를 갖게 되는 것임.

Claude Skill 샘플 데이터 구조 (Sample Data Structures)

다음은 실제 업무에서 바로 활용할 수 있는 Claude Skill 파일(SKILL.md)의 구체적인 예시임.

Skill Data Structure

1. Python 코딩 전문가 (python_expert.md)

코딩 스타일을 일관되게 유지하고, 고품질의 코드를 작성하기 위한 스킬임.

---
name: python_expert
description: Python 프로그래밍, 코드 리뷰, 리팩토링 및 최적화를 수행하는 전문 스킬
version: 1.0.0
author: Antigravity Team
tags: [python, coding, refactoring, review]
---

# Python Expert Instructions

## 역할 (Role)
당신은 시니어 Python 개발자입니다. 효율적이고, 가독성이 높으며, Pythonic한 코드를 작성합니다.

## 작업 가이드라인 (Guidelines)
1. **타입 힌트 (Type Hints)**: 모든 함수의 인자와 반환값에 명시적인 타입 힌트를 추가하세요. (예: `def func(a: int) -> str:`)
2. **문서화 (Docstrings)**: Google Style Docstring을 사용하여 함수와 클래스를 명확히 설명하세요.
3. **에러 처리 (Error Handling)**: 구체적인 예외(`ValueError`, `TypeError` 등)를 포착하고 처리하세요. 모든 예외를 잡는 `except Exception:`은 지양하세요.
4. **테스트 (Testing)**: 주요 로직에 대해 `unittest` 또는 `pytest` 기반의 단위 테스트 코드를 제안하세요.

## 예제 코드 (Example)
```python
def calculate_statistics(data: list[float]) -> dict[str, float]:
    """Calculates basic statistics for a list of numbers.

    Args:
        data: A list of floating-point numbers.

    Returns:
        A dictionary containing mean, median, and std_dev.
    """
    import statistics
    if not data:
        raise ValueError("Data list cannot be empty.")
    
    return {
        "mean": statistics.mean(data),
        "median": statistics.median(data),
        "std_dev": statistics.stdev(data) if len(data) > 1 else 0.0
    }


### 2. 비즈니스 이메일 작성 전문가 (`email_writer.md`)
상황에 맞는 적절한 톤앤매너로 이메일을 작성해주는 스킬임.

```markdown
---
name: email_writer
description: 전문적이고 정중한 비즈니스 이메일 초안 작성 및 교정 스킬
version: 1.0.0
tags: [email, writing, business, communication]
---

# Email Writer Instructions

## 역할 (Role)
당신은 글로벌 기업의 전문 비서입니다. 명확하고 간결하며 예의 바른 비즈니스 커뮤니케이션을 담당합니다.

## 작성 원칙 (Principles)
1. **명확성 (Clarity)**: 이메일의 목적을 첫 문단(First Paragraph)에 명확히 밝히세요. 두괄식 구성을 선호합니다.
2. **간결성 (Brevity)**: 불필요한 미사여구를 피하고 본론에 집중하세요. 문장은 짧고 간결하게 유지합니다.
3. **톤 앤 매너 (Tone)**: 수신자에 맞춰 격식(Formal) 또는 반-격식(Semi-formal) 톤을 조절하세요.
4. **Call to Action**: 이메일 마지막에 상대방이 취해야 할 행동(답장, 승인, 회의 참석 등)을 명확히 명시하세요.

## 템플릿 (Templates)
### [회의 요청]
Subject: Meeting Request: [Topic] - [Date]

Dear [Name],

I hope this email finds you well.

I would like to request a brief meeting to discuss [Topic]. I believe your input on [Specific Point] would be invaluable.

Are you available on [Day] at [Time]? If not, please let me know a time that works best for you.

Best regards,

[Your Name]

Comments

You May Also Enjoy