스킬 & 플러그인

스킬이란?

스킬은 반복 작업을 모듈화한 레시피입니다. 한 번 만들어두면 이름만 말하면 동일한 작업이 실행됩니다.

스킬이 없을 때

매번 이렇게 입력해야 함:
"이 폴더의 CSV를 읽고, 월별로 합계를 구하고, 전월 대비 증감을 계산하고,
상위 5개 항목을 추출해서, 워드 보고서로 만들어줘. 표 형식으로, 경영진 톤으로..."

스킬이 있을 때

"월간 매출 보고서 만들어줘"

끝. Claude가 스킬 파일을 읽고 알아서 전체 프로세스를 실행합니다.

스킬 찾기

공식 저장소

Anthropic이 제공하는 공식 스킬. 코워크 앱 내 사용자 지정 메뉴에서 탐색 가능.

커뮤니티 스킬

GitHub 등에서 다른 사용자가 공유한 스킬을 찾을 수 있습니다.

확인 방법

"현재 설치된 스킬 목록을 보여줘"

스킬 설치

방법 1: 사용자 지정 메뉴

1. 코워크 → 설정 → 사용자 지정 메뉴
2. 스킬 목록에서 원하는 스킬 찾기
3. 설치 클릭

방법 2: 파일 직접 복사

1. 스킬 파일(.md) 다운로드
2. 스킬 폴더에 복사:
   • macOS: ~/.claude/skills/
   • Windows: %USERPROFILE%\.claude\skills\

나만의 스킬 만들기

코워크에게 바로 부탁할 수 있습니다:

"매주 월요일마다 하는 주간 보고서 작업을 스킬로 만들어줘.
- 이 폴더의 데이터 파일을 읽고
- 주요 지표 요약 테이블을 만들고
- 전주 대비 변화를 분석하고
- 워드 보고서로 출력하는 스킬이야"

SKILL.md 구조

---
name: weekly-sales-report
description: 주간 매출 보고서를 자동 생성합니다. 매주 월요일 사용.
---

# 주간 매출 보고서 생성

## 작업 단계
1. 현재 폴더에서 이번 주 데이터 파일(.csv)을 찾는다
2. 주요 지표(매출, 거래건수, 객단가)의 합계를 구한다
3. 전주 대비 증감율을 계산한다
4. 상위 5개 제품을 추출한다
5. 워드 보고서로 출력한다

## 출력 형식
- 파일명: '주간보고서_YYYYMMDD.docx'
- 구성: 요약 테이블 → 증감 분석 → 상위 제품 → 인사이트

## 예시
입력: sales_20260324.csv ~ sales_20260330.csv
출력: 주간보고서_20260331.docx

실전 스킬 예시: 경쟁사 모니터링

---
name: competitor-watch
description: 경쟁사 3사의 최신 동향을 조사하고 비교표를 생성합니다.
---

# 경쟁사 동향 모니터링

## 대상
- A사 (www.a-company.com)
- B사 (www.b-company.com)
- C사 (www.c-company.com)

## 작업 단계
1. 각 회사의 최근 뉴스, 제품 업데이트, 가격 변동을 조사
2. 비교표 작성 (가격/신기능/시장반응)
3. 우리에게 미치는 영향 분석
4. 엑셀 비교표 + 마크다운 요약 보고서 생성

## 출력
- 'output/경쟁사동향_YYYYMMDD.xlsx'
- 'output/경쟁사동향_YYYYMMDD.md'

좋은 스킬의 3원칙

1. 하나의 스킬 = 하나의 목적 (여러 작업을 합치지 마세요)
2. 입출력 예시를 포함 (예시가 있으면 결과 품질이 올라갑니다)
3. 트리거 조건을 명확히 (description에 "언제 쓰는 스킬인지" 적어주세요)

실전: 스킬 디버깅 & 트러블슈팅

스킬을 만들었는데 기대한 대로 작동하지 않을 때, 아래 체크리스트를 순서대로 확인하세요.

스킬 점검 체크리스트

1. description이 모호하지 않은가? — "보고서 만들기"보다 "주간 매출 데이터를 요약하여 워드 보고서를 생성합니다"처럼 구체적으로
2. 입출력 예시가 있는가? — 예시가 없으면 Claude가 형식을 추측해야 합니다. ## 예시 섹션을 반드시 포함
3. 단계가 너무 많지 않은가? — 7단계 이상이면 스킬을 2개로 분리하세요 (예: 데이터 수집 스킬 + 보고서 생성 스킬)
4. 파일 경로가 명확한가? — 상대 경로보다 ~/Documents/reports/ 같은 절대 경로 사용
5. 트리거 조건이 명시되어 있는가? — description에 "매주 월요일", "CSV 파일이 있을 때" 등 사용 조건 기재

흔한 실패 패턴과 해결법

스킬 테스트 방법

스킬을 만든 후 반드시 테스트를 거치세요. 코워크에게 직접 요청하면 됩니다:

"이 스킬을 테스트해줘.
입력: sales_20260324.csv (매출 100건, 총액 5,000만원)
기대 출력: '주간보고서_20260331.docx' 파일, 요약 테이블 + 전주 대비 증감 포함"

테스트 후 확인할 것:

• 출력 파일이 기대한 경로에 생성되었는가?
• 표/차트의 구성이 명세와 일치하는가?
• 엣지 케이스 (데이터가 비어있을 때, 파일이 없을 때) 처리가 되는가?

스킬 공유 & 팀 운영

팀 내 스킬 공유 방법

추천 워크플로:

1. Slack #cowork-skills 채널에서 아이디어 제안
2. Git 저장소 skills/ 폴더에 PR로 등록
3. 리뷰 후 머지 → 팀 공유 폴더에 자동 배포

스킬 네이밍 컨벤션

팀에서 스킬이 늘어나면 이름 충돌과 혼란이 생깁니다. 팀명-작업명 형식을 추천합니다:

sales-weekly-report        (영업팀 주간 보고서)
mkt-competitor-watch       (마케팅팀 경쟁사 모니터링)
hr-onboarding-checklist    (HR팀 온보딩 체크리스트)
ops-daily-standup-summary  (운영팀 일일 스탠드업 요약)

추가 규칙:

• 영문 소문자와 하이픈(-)만 사용
• 약어는 팀 내에서 합의된 것만 사용 (예: mkt = 마케팅)
• description 첫 줄에 한글로 목적을 명확히 기재

버전 관리 팁

• 스킬 파일 상단 frontmatter에 version: 1.2 형태로 버전 표기
• 변경할 때마다 ## 변경 이력 섹션에 날짜와 변경 내용 기록
• 큰 변경은 새 스킬로 분리 (예: sales-weekly-report-v2)하여 기존 사용자에게 영향을 주지 않기

---
name: sales-weekly-report
description: 주간 매출 보고서를 자동 생성합니다. 매주 월요일 사용.
version: 1.2
---

## 변경 이력
- 2026-03-31 v1.2: 전월 대비 트렌드 차트 추가
- 2026-03-15 v1.1: 상위 제품 수를 5개 → 10개로 변경
- 2026-03-01 v1.0: 최초 생성

플러그인이란?

플러그인은 스킬의 확장 버전입니다. 스킬 + 커넥터 + 슬래시 명령 + 서브에이전트를 패키지로 묶은 것.

공식 플러그인 11종

설치 방법

1. 코워크 → 사용자 지정 메뉴 → 플러그인 탭
2. 원하는 플러그인 찾기 → 설치 클릭

회사에서 허용한 플러그인만 표시될 수 있습니다. 필요한 게 없으면 관리자에게 문의하세요.

스킬을 플러그인으로 발전시키기

잘 만든 스킬을 팀 전체가 쓸 수 있는 플러그인으로 만들 수 있습니다:

"이 스킬을 플러그인으로 만들어줘.
- 슬래시 명령어: /weekly-report
- 설명: 주간 매출 보고서 자동 생성
- 팀 전체가 사용할 수 있게"