Claude Cowork를 단순한 파일 정리 도구로만 쓰고 있다면 기능의 극히 일부만 활용하는 것이다. 플러그인을 직접 만들면 내 업무 방식, 출력 형식, 품질 기준을 정확히 아는 AI 직원이 생긴다. 한 번 설치하면 매일 나타나서, 아프다고 결근도 없이, 두 번 교육할 필요도 없이, 매주 조금씩 나아지는 직원이다.
플러그인이란
플러그인은 폴더다. Cowork가 특정 역할을 어떻게 수행할지 알려주는 구조화된 폴더다.
my-plugin/
├── .claude-plugin/
│ └── plugin.json # 이름, 역할, 설명
├── skills/
│ └── primary-task/
│ └── SKILL.md # 핵심 워크플로 — 단계별 절차
├── commands/
│ └── run-task.md # 슬래시 명령어: /prefix:command
├── references/
│ └── templates.md # 템플릿, 벤치마크, 예시
├── global-instructions.md # 상시 지시사항: 성격·기본값·선호
└── folder-instructions.md # 폴더별 컨텍스트plugin.json: 이 폴더가 플러그인임을 Cowork에 알리고, 역할과 활성화 조건을 정의한다.SKILL.md: AI 직원의 두뇌. 매 작업마다 따르는 단계별 절차다. 이 파일을 잘 만들면 나머지는 자동으로 따라온다.- Commands: 슬래시 명령어 트리거를 정의한다.
- References: 직원이 제대로 일하는 데 필요한 템플릿·업계 데이터·예시 자료다.
- Global Instructions: 상시 지시사항 — 성격, 커뮤니케이션 스타일, 품질 기준, 기본 가정.
1단계: 역할 조사 (30분)
파일 하나도 작성하기 전에 AI 직원이 정확히 무슨 일을 할지 파악해야 한다.
Claude를 열고 다음 프롬프트를 사용한다:
“Research the complete professional workflow for a [ROLE] in [INDUSTRY]. Include: the step-by-step process they follow, tools and data sources they use, key metrics and decision criteria, common output formats, and expert-level edge cases and pitfalls. Be comprehensive — I am building an automated workflow from this.”
출력을 꼼꼼히 읽는다. 이것이 스킬 파일의 원재료다.
그 다음 자신을 인터뷰한다:
- 내 버전의 프로세스는 어떻게 생겼나?
- 어떤 지름길을 쓰는가?
- 항상 실행하는 품질 검사는 무엇인가?
- 항상 주시하는 실수는 무엇인가?
- “좋은” 결과물과 “나쁜” 결과물의 차이는 무엇인가?
최고의 AI 직원은 일반적인 모범 사례가 아니라 내 구체적인 전문성으로 만들어진다.
2단계: 스킬 파일 작성 (60분)
SKILL.md는 AI 직원의 두뇌다. 직원이 자신의 일을 어떻게 하는지에 관한 모든 것이 여기 있다.
기본 구조:
name: [skill-name]
description: |
[언제 이 스킬이 활성화되나? 트리거 문구를 공격적으로 나열한다.
"사용자가 다음 중 하나를 말할 때 이 스킬을 사용하라: [5~7가지 문구 나열].
다음에는 사용하지 말 것: [비슷하게 들리지만 다른 상황 나열]."]
# 개요
[한 단락: 이 스킬이 무엇을 하고 어떤 결과물을 만드는지]
## 절차
[번호가 매겨진 단계. 각 단계는 구체적이고, 검증 가능하며, 모호하지 않다.
"데이터를 분석한다"가 아니라 "현재 기간과 이전 기간을 비교하고 각 지표의 변화율을 계산한다."]
1. [구체적 지시가 담긴 단계]
2. [구체적 지시가 담긴 단계]
3. [구체적 지시가 담긴 단계]
## 출력 형식
[결과물이 정확히 어떻게 생겼는지]
- 제목 형식
- 섹션 헤더 순서
- 길이 제한
- 서식 요건
## 규칙
[타협 불가 품질 기준]
- [규칙 1]
- [규칙 2]
- [규칙 3]
## 엣지 케이스
[상황이 단순하지 않을 때 어떻게 할지]
- [상황]이면: [구체적 행동]
- [상황]이면: [구체적 행동]
## 품질 체크리스트
[결과물 전달 전 실행할 검사 목록]
- [ ] [검사 1]
- [ ] [검사 2]
- [ ] [검사 3]YAML 프론트매터의 description 필드가 가장 중요하다. 너무 모호하면 스킬이 절대 활성화되지 않는다. 너무 광범위하면 무관한 대화를 가로챈다. 트리거 문구 5~7개와 명시적인 부정 경계를 함께 적는다.
3단계: 지원 파일 만들기 (30분)
plugin.json:
{
"name": "my-ai-employee",
"description": "A [ROLE] that [WHAT IT DOES] for [WHO]",
"version": "1.0"
}슬래시 명령어 (commands/ 폴더에 마크다운 파일로 생성):
# /employee:run
현재 폴더의 데이터에 [primary-task] 스킬을 실행한다.
단계:
1. 작업 디렉터리의 모든 관련 파일 읽기
2. SKILL.md의 모든 단계를 따라 스킬 실행
3. 결과물 전달 전 품질 체크리스트 실행
4. 결과물을 [형식]으로 현재 폴더에 저장
5. 생성된 내용의 간략한 요약 제공Global Instructions:
당신은 [INDUSTRY]에서 [YEARS]년 경력의 [ROLE]입니다.
상시 지시사항:
- 결론을 먼저, 설명은 나중에
- 구체적인 숫자를 항상 사용하고, 모호한 표현 금지
- 데이터가 없거나 불분명하면 표시할 것 — 절대 추측 금지
- 기본 출력 형식: [내 선호 형식]
- 커뮤니케이션 스타일: [직접적/대화형/격식체]
- 확신이 없으면 가정하기보다 먼저 질문할 것Reference 파일: 직원에게 필요한 템플릿, 벤치마크 데이터, 업계 기준, 예시를 추가한다. 참고 자료가 구체적일수록 출력이 전문가 수준에 가까워진다.
4단계: 설치, 테스트, 개선
플러그인 폴더를 Claude Cowork 환경에 설치한다. Cowork에서 다음 프롬프트를 사용한다:
“I have a plugin folder at [PATH]. Verify the structure is valid — check plugin.json, SKILL.md frontmatter, and command files. Install it and run a quick test with the simplest slash command.”
그 다음 실제 업무로 테스트한다. 샘플 데이터가 아닌, 실제 워크플로의 실제 데이터로.
5회 서로 다른 입력으로 실행한다. 매 실행 후 평가한다:
- SKILL.md의 모든 단계를 따랐는가?
- 규칙을 지켰는가?
- 출력이 형식 명세와 일치하는가?
- 이 결과물을 그대로 사용할 수 있는가, 아니면 상당한 수정이 필요한가?
뭔가 미흡할 때마다 SKILL.md를 업데이트한다. 규칙을 추가하고, 단계를 더 구체화하고, 좋은 것과 나쁜 것의 예시를 추가한다.
이 개선 루프가 평범한 AI 직원을 탁월한 직원으로 만든다. 10회째 실행이면 1회째보다 품질이 극적으로 높아진다.
5단계: AI 직원 확장
1차 스킬이 안정적으로 작동하면 직원 역량을 확장한다.
2번째 스킬 추가: 리서치 분석가가 경쟁사 모니터링도 한다. 콘텐츠 전략가가 콘텐츠 재활용도 한다. 새 스킬은 skills/ 폴더의 새 SKILL.md다.
자동화 워크플로 구성: 슬래시 명령어 하나로 여러 스킬을 멀티 단계 프로세스로 엮는다.
리서치 → 분석 → 보고서 → 배포명령어 하나, 스킬 4개, 수동 작업 0개.
예약 실행: 매주 금요일 오후 4시 주간 리포트, 매일 아침 7시 인박스 처리, 매주 월요일 경쟁사 스캔. 진정한 자율 실행이다.
서브에이전트 추가: 복잡한 워크플로에서 AI 직원이 여러 서브에이전트를 병렬로 구동한다. 순차 처리 대신 파일 5개를 동시에 처리. 서브에이전트를 추가할수록 속도 향상이 복리로 쌓인다.
성과 리뷰 시스템
평범한 AI 직원과 탁월한 AI 직원의 차이는 여기서 결정된다.
매주 출력 결과물을 리뷰한다. 완벽하게 작동한 것, 수정이 필요했던 것, 직접 다시 해야 했던 것을 기록한다. 그 다음 SKILL.md를 업데이트한다.
주당 15분이다. 두 달에 걸친 복리 효과는 엄청나다.
- 1주차: 직원이 작동한다.
- 4주차: 직원이 잘 한다.
- 8주차: 몇 달 걸리던 신입 사원 교육 수준의 결과물을 만든다.
도구가 스스로 나아지는 게 아니다. 내 지시가 나아진다. 그리고 지시는 전적으로 내 손에 있다.
지금 당장 시작하는 법
매주 가장 많은 시간을 쓰는 작업을 고른다. 하기 싫은 것. 매번 같은 프로세스를 따르는 것.
이 가이드를 따라 2시간 동안 플러그인을 만든다.
오늘 저녁이면 가장 시간 소모가 큰 작업을 처리하는 AI 직원이 생긴다. 다음 달이면 어떻게 직접 했는지 의아해질 것이다.