Claude Code에는 SKILL.md라는 게 있습니다. "이런 상황에서는 이렇게 해줘"를
적어 두면 Claude가 알아서 꺼내 쓰는 파일이에요. 편리하지만 막상 처음
만들려고 하면 무엇을 어떤 순서로 적어야 하는지가 막막합니다.
Tailor는 그 부분을 대신 물어봐 줍니다. 몇 가지 질문에 답하면 쓸 만한 초안이 나오고, 그 초안이 왜 그렇게 생겼는지도 함께 보여줍니다.
Tailor는 Claude Code를 처음 접하는 사람부터 이미 스킬을 만들어 본 숙련된 사용자까지 함께 쓸 수 있도록 설계했습니다. 기술 용어나 구체적인 값을 덜어내지 않되, 처음 나오는 용어에는 짧은 풀이를 붙였습니다. 처음에는 쉽게 시작하고, 익숙해진 뒤에도 필요한 만큼 구체적으로 다룰 수 있습니다.
몇 가지 질문에 답하며 나에게 맞는 SKILL.md 초안을 만듭니다.
실제 생성 결과 — 완성된 SKILL.md와 AI 자체 점검을 함께 확인할 수 있습니다.
| 경로 | 설명 | |
|---|---|---|
| 용어 사전 | /glossary |
"스킬", "에이전트", "CLI" 같은 개념 21개를 쉬운 비유로 풀어 줍니다. AI를 부르지 않습니다 |
| 스킬 생성기 | /create |
질문에 답하면 SKILL.md 초안을 만들어 줍니다. 핵심 기능입니다 |
| 갤러리 | /gallery |
참고할 만한 스킬을 둘러보고 받아 갑니다 |
/create에 들어가면 만드는 방법을 먼저 고르게 됩니다. 둘은 잘하는 것이
다릅니다.
| 이 사이트에서 만들기 | 내 Claude로 이어서 만들기 | |
|---|---|---|
| 어디서 만드나 | 서버가 Claude 모델을 1~2단계로 처리 | claude:// 딥링크로 본인 Claude 세션 |
| 참고 코퍼스 | 함께 들어갑니다 | 링크에 담기지 않아 못 넘깁니다 |
| 출처 표기 | 결과 화면에 표시됩니다 | 붙지 않습니다 |
| 내 프로젝트 파일 | 볼 수 없습니다 | 보면서 물어볼 수 있습니다 |
| 비용 | 서비스 운영자 부담 | 본인 Claude 계정 |
문서의 짜임새만 놓고 보면 웹 경로가 대체로 낫습니다. 이 차이는 고르기 전에 읽을 수 있도록 화면에도 적어 두었습니다.
이관 경로의 저장 원칙 넘기는 프롬프트에는 "초안을 보여주고 승인받은 뒤, 저장 위치를 물어보고, 저장 직전 다시 확인받고 나서만 저장하라" 는 지시가 들어 있습니다. 다만 이건 코드가 아니라 지시문이라 100% 강제되지는 않습니다.
pnpm install
pnpm devhttp://localhost:3000에서 열립니다.
Important
생성 기능을 쓰려면 Claude API 키가 필요합니다.
저장소 루트에 .env.local 파일을 만들고 키를 넣어 주세요
(.env.example 참고).
# .env.local
ANTHROPIC_API_KEY=sk-ant-...키는 console.anthropic.com에서 발급받습니다.
.env.example에 있는 CORPUS_ROUTING_MODE는 선택이고, 없으면 전체 코퍼스를
넣는 기본 동작을 씁니다.
운영 계측을 쓸 때만 SUPABASE_URL과 서버 전용 SUPABASE_SECRET_KEY를
설정합니다. 두 값이 없어도 스킬 생성은 그대로 동작하며 계측 저장만
건너뜁니다(fail-open). 표 정의는 docs/operations/generations-table.sql에
있습니다.
.env.local은 .gitignore에 잡혀 있어 커밋되지 않습니다. Anthropic 키는
src/app/api/generate-skill/route.ts, Supabase 키는
src/app/api/generate-skill/observation-store.ts에서 서버에서만 읽으며
브라우저로 내려가지 않습니다.
키가 없어도 용어 사전과 갤러리는 그대로 동작합니다. 둘 다 AI를 호출하지
않는 정적 페이지예요. 키 없이 /create에서 생성을 시도하면 "API 키가 설정되어
있지 않다"는 안내가 뜹니다.
검사 명령
pnpm lint # Biome (lint + format)
pnpm build # 프로덕션 빌드
pnpm exec tsc --noEmit # 타입 검사
pnpm lint:corpus # 코퍼스 작성 규칙
pnpm count:audit # 감사 반영률 보고·문서 매핑 검사
pnpm check:parser # 모델 응답 태그 파서 회귀
pnpm check:logging # 서버 로그 허용 목록 회귀
pnpm check:observation # Supabase 계측·저장 경로 회귀
pnpm check:upstream-errors # Anthropic 오류 분류·중단 회귀
pnpm check:input-limits # 입력 길이 상한 회귀
pnpm check:routing # 묶음 선택·전달 목록 회귀
pnpm check:routing-production # 프로덕션 full·routed 정책 회귀
pnpm check:routing-eval # 라우팅 평가 사전등록 검사
pnpm check:routing-comparison # full·routed 비교 사전등록 검사
pnpm check:routing-fallback # 폴백 안전장치 무비용 검사
pnpm check:corpus-render # 코퍼스 렌더 결과 대조check:routing, check:routing-production, check:routing-fallback,
check:corpus-render는 pnpm dev가 3000 포트에 떠 있어야 합니다.
check:routing-fallback은 기록된 free-check-results.json을 새 실행 결과로
덮어쓰므로, 검사 뒤 Git diff를 확인하고 원래 기록으로 되돌려야 합니다. 위 검사는
전부 API 비용이 들지 않습니다.
생성 프롬프트에는 공개 스킬에서 미리 정리해 둔 "좋은 패턴" 이 함께 주입됩니다. 원문을 실행 중에 다시 읽지 않습니다.
넣는 방식은 CORPUS_ROUTING_MODE로 고릅니다. 기본값 full은 코퍼스를 통째로
넣어 Sonnet 생성 한 단계로 처리합니다. routed는 최초 생성에 한해 저비용
모델(Claude Haiku 4.5)이 필요한 패턴 묶음을 먼저 고르고, Sonnet이 선택된
코퍼스로 생성하는 두 단계입니다. 네트워크·deadline·5xx·분류되지 않은 요청
오류나 선택 후처리 실패는 전체 주입으로 돌아갑니다. 결제·사용량 상한·인증·429
오류는 Sonnet을 부르지 않고 중단합니다. 수정 요청은 설정과 무관하게 항상
full입니다.
| 카테고리 | 패턴 | 문서 골격 | 출처 스킬 |
|---|---|---|---|
| 9 | 148 | 4 | 13 |
baseline 카테고리만 요청 종류와 무관하게 항상 주입됩니다.
남의 것을 정리해 담을 때 지키는 원칙
- 소스를 두 등급으로 나눕니다. 라이선스가 확인된 소스(MIT / Apache-2.0)는 값 리터럴까지 옮기고, 확인되지 않은 소스는 개념·방법만 우리 말로 요약해 담습니다(문구·목록·표·템플릿은 담지 않습니다). 어느 등급이든 출처는 표기합니다 — 표기를 생략하면 화면에서 자체 제작으로 보이는데, 그건 틀린 신호입니다.
- 각 소스의 저장소와 라이선스는 직접 확인해 기록합니다. 검색 결과의
라이선스 표기는 믿지 않습니다. 확인하지 못했으면
"확인되지 않음"이라고 적습니다 — 화면에 그대로 표시되는 값이라, 추측을 적으면 사용자에게 거짓을 보여주게 됩니다. - 표기는 "원문을 읽었다"가 아니라 "정리한 패턴을 참고했다" 입니다. 이번 생성에 실제로 쓰인 것만 표시합니다.
- 표기하는 것은 근거를 짚을 수 있어야 합니다. 완성된
SKILL.md에서 확인할 수 없는 항목은 출처 크레딧에 넣지 않습니다.
규칙 본문은 src/data/reference-corpus.ts 머리 주석에, 소스 검증 절차는
docs/corpus-sources.md에 있습니다. 코퍼스가 원문을 제대로 옮겼는지는
docs/corpus/에 소스별 감사 기록으로 남깁니다 — 파일 목록·바이트·md5까지
적습니다.
이 판단은 법률 자문이 아닙니다.
품질을 눈대중으로 판단하지 않으려고, 무엇을 바꿨고 그래서 어떻게 됐는지를 그때그때 적어 두었습니다.
docs/corpus/— 코퍼스가 원문을 제대로 옮겼는지 소스별로 대조한 감사 기록 11편. 어떤 파일을 어디까지 읽었는지 파일 목록·바이트·md5까지 적습니다docs/experiments/— 생성 품질 실험 기록 9편과 원자료. 모델·설정 비교, 코퍼스를 채웠을 때 결과가 실제로 달라지는지, 표기한 출처가 결과물에 정말 반영됐는지를 블라인드로 채점한 기록 등이 있습니다
나중에 뒤집힌 결론도 지우지 않고, 문서 상단에 정정 문구만 덧붙이는 방식으로 관리합니다. 본문을 고치면 "그때 무엇을 쟀는가"가 바뀌기 때문입니다. 그래서 결론을 인용하기 전에는 문서 맨 위를 먼저 봐 주세요.
펼쳐 보기
src/app/ 페이지 + API 라우트
api/generate-skill/ 생성 API
route.ts 입력 검사 → 생성 → 응답
generate.ts 생성 한 번의 전체 흐름
prompt.ts 프롬프트와 코퍼스 렌더
routing.ts 패턴 묶음 선택과 전달 목록
routing-policy.ts / generation-routing.ts
full·routed 판정과 안전장치
upstream-error.ts Anthropic 오류 분류
request-validation.ts 입력 길이·형식 검사
telemetry.ts 서버 로그로 나가는 값
observation.ts / observation-store.ts
허용된 운영 계측 값과 Supabase 저장
api/route-preview/ 라우팅 미리보기 (개발 전용, 배포 환경에서는 404)
api/eval-ab/ 실험용 평가 하네스 (개발 전용, 배포 환경에서는 404)
api/corpus-snapshot/ 코퍼스 렌더 덤프 (개발 전용, 배포 환경에서는 404)
src/components/create/ 마법사 · 결과 화면 · 이관 패널
src/data/
reference-corpus.ts 참고 코퍼스 — 패턴 + 문서 골격
gallery.ts 갤러리 데이터
glossary.ts 용어 사전 데이터
wizard-questions.ts 마법사 질문 정의
src/lib/
generation-errors.ts 오류 코드·문구·재시도 정책 (서버·클라이언트 공용)
input-limits.ts 입력 길이 상한 (서버·클라이언트 공용)
tools/ 코퍼스 lint·렌더·감사와 파서·로그·오류·입력·라우팅·계측 검사
docs/corpus/ 원문 감사 기록
docs/experiments/ 생성 품질 실험 기록 + 원자료
docs/operations/ 운영 계측 표 정의와 판정 SQL
Next.js (App Router) · React · TypeScript · Tailwind CSS · pnpm · Biome · GSAP + Framer Motion · Anthropic SDK (생성 Claude Sonnet 5, 코퍼스 선택 Claude Haiku 4.5) · Supabase REST (운영 계측)
참고 코퍼스는 다른 분들이 만든 공개 스킬에서 패턴을 정리한 것입니다. 각
소스의 저작자와 라이선스는 src/data/reference-corpus.ts에, 감사 기록은
docs/corpus/에 있습니다. 생성 결과 화면에도 이번 생성에 실제로 쓰인 패턴의
출처가 표시됩니다.
© 2026 Guhn Park
코드는 공개해 두었지만 따로 오픈소스 라이선스를 부여하지는 않았습니다. GitHub
안에서 살펴보고 fork해 실험하거나, issue와 pull request로 더 나은 방법을 제안해
주시는 건 언제든 환영합니다. 그 밖의 이용은 먼저 연락 부탁드립니다. 전문은
LICENSE에 있습니다.
참고 코퍼스에 정리된 패턴의 원출처는 각자의 라이선스를 따릅니다 — 저작자와
라이선스는 src/data/reference-corpus.ts와 docs/corpus/에 기록되어 있습니다.