21개의 스킬 전체 설계
!이미지
제 Claude Code 환경에는 21개의 스킬이 있습니다. 각각 독립적인 전문 기능을 가지며, 5개 레이어로 나뉩니다.
연구 레이어
- research-ai: AI 뉴스 자동 수집 및 선별. RSS 피드와 Claude 선별을 결합한 하이브리드 방식.
- research-insight: 잠재 니즈와 구조적 문제 탐색. 정성 데이터의 삼각측량을 통해 '언어화되지 않은 문제'를 발견.
제작 레이어
- writer-article: note 아티클의 엔드투엔드 작성. 구조 설계부터 본문, 상용구 삽입, 파일 출력까지.
- writer-post: X 게시물의 디자인, 작성, 사후 관리.
- writer-copy: 웹사이트, LP, 광고용 카피라이터.
- thumbnail: 썸네일 이미지 생성 프롬프트 설계.
- diagram: 섹션 일러스트레이션 설계.
- table: HTML/CSS 테이블 생성.
- slide-builder: 웹비나 슬라이드 사이트 구축.
- ui: 웹사이트, LP, 대시보드의 HTML/CSS/JS 구현.
품질 관리 레이어
- fact-check: 숫자, 인용, 출처 표기, 인과 관계를 원본 대비 검증.
- design-score: 배너, 썸네일, LP 등의 디자인을 100점 만점으로 평가.
운영 레이어
- secretary: 일정, 할 일, 스케줄 관리.
- accounting: 청구서 생성 및 매출 장부 입력.
- message: X DM, 이메일, 문의에 대한 답변 텍스트 작성.
- seminar: 세미나 기획의 엔드투엔드 설계.
분석 레이어
- today-analytics: 최근 X 성과 집계.
- week-review: 주간 콘텐츠 성과 리뷰.
- atom-suggest: 다음에 게시할 콘텐츠 후보 제안.
또한 외부 클라이언트용 전용 변형(diagram-shiftai / thumbnail-shiftai / slide-builder-shiftai)도 있습니다.
모든 것은 ~/.claude/skills/ 디렉토리 아래 폴더로 존재하며, CLAUDE.md가 오케스트레이터 역할을 합니다.
CLAUDE.md를 통한 스킬 통합 설계 철학
!이미지
21개의 스킬을 각각 따로 돌리는 것은 무의미합니다. 중요한 것은 모든 스킬이 동일한 컨텍스트를 공유한다는 점입니다.
이러한 '컨텍스트 공유'를 실현하는 것이 바로 CLAUDE.md입니다.
CLAUDE.md에는 다음 내용이 포함됩니다:
- Takuya Kawai의 프로필, 경력, 직함
- 서비스 정의(퍼널 구조, 가격 체계, 각 서비스의 포지셔닝)
- 승인 규칙(자동 실행할 것과 에스컬레이션할 것)
- 품질 기준(Output Gate 판단 조건)
- 데이터 레이어 정의(atoms.csv / pipeline.csv / outputs.csv 운영 규칙)
어떤 스킬을 호출하든 이 CLAUDE.md가 먼저 로드됩니다. 즉, 모든 스킬이 '동일한 성격, 동일한 판단 기준, 동일한 품질 기준'으로 작동합니다.
이것이 단순히 스킬을 나열한 것과 '21개의 전문 능력을 가진 한 사람'의 차이입니다.
스킬을 분리해서 각각 독립적으로 운영하면, 스킬 A가 조사한 결과를 바탕으로 스킬 B가 아티클을 작성할 때 A의 컨텍스트가 사라집니다. B는 브랜드 톤을 다시 로드하고, 과거 아티클과의 일관성을 확인하고, 페르소나를 재구축해야 합니다.
CLAUDE.md 통합을 사용하면 이 재구축 비용이 제로입니다. 연구 스킬이 수집한 자료가 그대로 아티클 스킬의 입력이 됩니다.
아티클이 생성됨과 동시에 썸네일과 다이어그램이 자동으로 설계됩니다. 완성된 아티클은 사실 확인을 거쳐 SNS 게시물로 확장됩니다.
성과 데이터는 분석 스킬이 수집하여 다음 콘텐츠 전략에 피드백됩니다.
컨텍스트 공유가 품질과 속도를 모두 결정합니다.
스킬 간 데이터 흐름
!이미지
스킬 통합의 효과를 구체적으로 살펴보겠습니다.
데이터는 3개의 CSV 파일로 관리됩니다:
- atoms.csv: 콘텐츠의 씨앗(뉴스, 경험, 분석 결과). 모든 콘텐츠의 원자재.
- pipeline.csv: 각 원자(atoms)를 어떤 채널에 배포할지 계획. 상태 관리 포함.
- outputs.csv: 실제 게시된 콘텐츠 기록. 성과 데이터도 축적.
흐름은 다음과 같습니다:
research-ai는 매일 아침 AI 뉴스를 수집하여 atoms.csv에 추가합니다. research-insight는 매주 잠재 니즈를 탐색하여 atoms.csv에 추가합니다.
배포 판단은 pipeline.csv에서 실행됩니다. "이 원자는 note 아티클로", "이 원자는 X 게시물로", "이 원자는 둘 다." 판단 기준은 참여율과 노출수를 기반으로 자동화됩니다.
writer-article이 아티클을 작성할 때는 atoms.csv의 원본 데이터와 CLAUDE.md의 품질 기준이 동시에 로드됩니다. 아티클 완료 시 썸네일과 다이어그램이 프롬프트를 생성하고, fact-check가 검증을 실행합니다.
게시 후에는 today-analytics와 week-review가 성과를 수집하여 outputs.csv에 축적합니다. 그 데이터는 atom-suggest로 흘러가 다음에 작성할 내용을 결정하는 기초가 됩니다.
모든 스킬이 동일한 데이터베이스를 참조하고 업데이트하기 때문에 이 루프가 회전합니다.
하루 60분 업무 타임라인
!이미지
다음은 실제 하루 업무입니다.
!이미지
총 약 60분.
같은 작업을 수동으로 했다면 아티클만 3-4시간이 걸리고, SNS, 이메일, 슬라이드, 청구서까지 포함하면 하루 8시간을 훨씬 넘깁니다.
단 60분밖에 걸리지 않는 이유는 스킬 간 인수인계 시간이 거의 제로이기 때문입니다. 아티클이 작성되면 썸네일이 자동으로 설계됩니다.
사실 확인은 자동으로 실행됩니다. SNS 확장 텍스트는 자동으로 생성됩니다. '다음 작업을 위해 정보를 다시 정리'하는 시간이 없습니다.
구축 과정 — 전직 디자이너로서 한 일
!이미지
저는 프로그래밍 기술 없이 이 시스템을 구축했습니다.
다음 5단계가 필요했습니다:
1단계: 업무의 언어화
당신은 무엇을, 어떤 순서로, 어떤 판단 기준으로 하고 있나요? 이걸 Markdown으로 작성하는 작업이 전체의 80%를 차지합니다.
Claude Code 설정에 관한 것이 아닙니다. 자신의 업무를 목록화하는 것입니다.
*"note 아티클을 쓸 때, 먼저 무엇을 확인하지?"
"썸네일을 만들 때, 어떤 기준으로 카피를 결정하지?"
"청구서를 발행할 때, 어디서 어떤 정보를 가져오지?"*
암묵지가 되어 있던 모든 업무 절차를 명확하게 설명했습니다.
2단계: CLAUDE.md 설계
모든 스킬의 공통 규칙, 브랜드 정의, 승인 흐름, 품질 기준을 하나의 파일로 통합합니다.
이는 '회사 관리 방침 문서'에 해당합니다. 어떤 스킬을 호출하든 이 방침에 따라 작동합니다. 성격과 판단 기준의 통일은 여기서 결정됩니다.
https://x.com/kawai_design/status/2031673798479790362
3단계: SKILL.md 생성
각 스킬의 트리거 조건, 실행 절차, 품질 기준, 참조 파일, 출력 대상을 Markdown으로 정의합니다. 스킬당 약 100-300줄입니다.
writer-article의 경우 '구조 템플릿', '톤 규칙', '상용구 삽입 위치', '제목 규칙', '과거 아티클 중복 확인 절차'가 모두 작성됩니다.
https://x.com/kawai_design/status/2022911084588675503
4단계: 참조 데이터 준비
상용구 텍스트, 브랜드 가이드라인, 과거 아티클 아카이브(878개), 카피 패턴 모음, 일러스트레이션 카탈로그. 스킬이 참조할 '교재'를 준비합니다.
과거 아티클은 완전히 데이터베이스화되어 키워드 검색이 가능합니다. 새 아티클을 작성하기 전에 항상 과거 아티클을 검색하여 같은 주제의 기존 아티클과 모순되지 않도록 합니다.
5단계: 반복적 개선
처음부터 완벽한 형태가 되지는 않습니다. 사용하고, 출력을 보고, SKILL.md를 수정합니다. 이 반복을 통해 정확도가 향상됩니다.
구축 기간은 약 1주일이었습니다. 하지만 '일주일 내내 구축'한 것이 아니라, 일주일 동안 Claude Code로 정상 업무를 수행하면서 성공 패턴을 스킬로 전환한 결과입니다.
컨텍스트 공유가 중요한 이유
!이미지
스킬 통합의 핵심을 조금 더 깊이 살펴보겠습니다.
제 writer-article 스킬은 아티클을 작성하기 전에 항상 과거 아티클 아카이브를 검색합니다. 878개 아티클의 데이터베이스에서 관련 아티클을 가져와 기존 주장과 모순되지 않는지 확인한 후 작성을 시작합니다.
이것이 가능한 이유는 '과거 아티클 아카이브 참조 방법', '검색 명령어', '아카이브 저장 경로'가 CLAUDE.md에 명확히 명시되어 있기 때문입니다.
writer-article 스킬은 자체적으로 데이터베이스를 가지고 있지 않습니다. 단지 공유 데이터 레이어를 참조할 뿐입니다.
마찬가지로, fact-check 스킬이 사실 확인을 수행할 때는 CLAUDE.md의 품질 기준을 참조합니다.
*"과장된 표현은 없는가?"
"원천 소스가 말하지 않은 것을 확정적으로 쓰고 있지 않은가?"
"숫자의 근거가 확보되었는가?"*
이러한 기준이 스킬마다 다르면 품질이 일관되지 않을 것입니다.
design-score 스킬이 썸네일을 평가할 때도 CLAUDE.md의 동일한 브랜드 정의를 참조합니다. 브랜드 톤을 이해한 후 평가하기 때문에 의미 있는 피드백을 반환합니다.
모든 스킬이 '동일한 기억'을 공유하는 것. 이것이 통합 설계에서 가장 중요한 포인트입니다.
지금 시작하는 분들을 위해
!이미지
"21개의 스킬은 너무 많아요. 어디서부터 시작해야 하죠?"
자연스러운 질문입니다.
답은 간단합니다. 매일 하는 단 하나의 작업을 스킬로 만드세요.
제가 처음 스킬로 만든 것은 note 아티클 작성이었습니다. 구조 템플릿, 상용구 삽입 위치, 톤 규칙. 이것들을 SKILL.md로 작성하는 것이 출발점이었습니다.
첫 번째 스킬이 안정되면 두 번째를 만듭니다. 두 번째가 완성되면 첫 번째와의 연결을 고민합니다. 이 과정을 반복하면 어느새 10개, 20개의 스킬이 완성됩니다.
중요한 것은 한 번에 모든 것을 만들려고 하지 않는 것입니다.
구체적인 시작 방법은 다음과 같습니다:
1. 매일 하는 하나의 작업을 선택하세요
이메일 답변, SNS 게시물, 보고서 작성, 회의록 정리. 무엇이든 좋습니다. '매번 똑같은 내용을 설명하고 있다'고 느껴지는 작업이 이상적입니다.
2. 그 작업의 절차를 Markdown으로 작성하세요
완벽할 필요는 없습니다. '이것을 먼저 확인하고, 이것을 작성하고, 마지막으로 여기에 저장한다' 정도면 충분합니다.
3. Claude Code가 SKILL.md로 읽게 하세요
작성한 절차를 SKILL.md 형식으로 정리하여 ~/.claude/skills/에 배치합니다.
4. 사용하고 수정하세요
출력이 이상하면 SKILL.md를 수정합니다. 3-5회 수정으로 실용적인 수준에 도달합니다.
5. 두 번째를 만들고 연결하세요
두 번째 스킬이 완성되면 CLAUDE.md에 공통 규칙을 정의합니다. 스킬 통합은 여기서부터 시작됩니다.
업무에서 '매번 똑같은 내용을 설명하고 있다'고 느껴지는 순간이 다음 스킬의 씨앗입니다.
['무엇에 써야 할지 모르겠다'를 해소하는 40분]
전문가 Claude Code 작업 공간 전체 공개
선착순 100명 한정: 웨비나 상세 ↓
─────────────────
이 외에도 AI 시대의 미래 예측, 도구 설명 등 많은 아티클을 게시하고 있습니다. 모두 무료로 읽을 수 있으니 확인해 보세요.
https://x.com/kawai_design/articles
─────────────────
교육이나 강연 관련 문의나 상담은 프로필에 명시된 웹사이트를 통해 연락해 주세요.
