My Claude Skills
choms0521/my-claude-skills
Skills customizados para Claude Code: reviews, automação, coaching e geração criativa
Ver no GitHubColeção de skills customizados para Claude Code, incluindo code review multi-LLM, download de MP3, coaching de entrevistas frontend, geração de música e orquestração de agentes. Cada skill é modular e testável, com documentação em SKILL.md.
Instalação
npx convez-ai choms0521/my-claude-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Code review paralelo com múltiplos LLMs (Claude, Codex, Gemini)
- Automação de processamento de comentários GitHub Copilot em PRs
- Coaching adaptativo para entrevistas de frontend com avaliação multi-juízes
- Geração de músicas com design intencional de progressões e letra
- Diagnóstico de comportamento e disciplina de agentes IA
Veredito

Repositório técnico e bem estruturado com skills avançados para desenvolvedores JavaScript/TypeScript em Claude Code. Cobre nichos específicos (multi-review, music generation, agent supervision) com implementações sofisticadas, mas requer contexto profundo do ecossistema Claude e conhecimento de MCP/runtime para aproveitamento máximo.
README
A tradução para o português deste README ainda está na fila.
My Claude Skills
Claude Code에서 사용하는 커스텀 스킬 모음 저장소입니다.
직접 만든 스킬들을 지속적으로 추가하고 관리하기 위한 공간입니다.
참고:
src/디렉토리는 스킬 테스트·데모용 샘플 코드입니다. 실제 서비스 코드가 아닙니다.
구조
.claude/skills/
└── <skill-name>/
└── SKILL.md ← 스킬 정의 파일
각 스킬은 .claude/skills/<skill-name>/SKILL.md 형태로 구성됩니다.
등록된 스킬
| 스킬 | 설명 | 사용법 |
|---|---|---|
| multi-review | 3개 LLM(Claude, Codex, Gemini) 병렬 코드 리뷰 + 종합 + 사용자 승인 후 수정 — Codex/Gemini 미가용 시 Claude가 대역(security/clarity 관점) 수행으로 항상 3개 리뷰 파일 생성 | /multi-review [파일 | --workspace | --staged] |
| check-github-copilot-review | GitHub Copilot 리뷰 코멘트 자동 처리 — 지적을 무조건 수용하지 않고 코드를 직접 검증해 실제 결함만 수정, 취향·오탐 제안은 사유 댓글과 함께 기각, 확정 못 한 항목은 보류(HOLD)하여 사용자에게 확인. 처리 후 resolve + 커밋·푸시, 최대 3사이클 자동 폴링 | /check-github-copilot-review [PR URL | PR번호] [--reset] |
| mp3-downloader | YouTube/YouTube Music에서 MP3 다운로드 (yt-dlp+ffmpeg 기반, 자동 의존성 설치, 디렉토리 자동 생성) | /mp3-downloader <url> [--out <dir>] |
| fe-interview | 프론트엔드 면접 코치 — Knowledge Graph 기반 적응형 면접. 3명 면접관(CTO/팀리드/시니어), S/A/B/C/D 등급, 합의 평가, 개선 로드맵 | /fe-interview [--mode graph|classic] [--resume <파일>] [--level junior|mid|senior] [--length short|medium|long] |
| persona-builder | 봇 페르소나 정의 — 5개 차원(말투/감정 톤/대화 성향/입장-세계관/호칭) 인터뷰 후 Personality Config 생성. Tester Agent 샘플 대화 검증 포함 | /persona-builder [--scope workspace|global] [--remove] [--quick] |
| music-generator | mmx CLI 기반 음악 생성 — 음악 설계(코드 진행/전조/다이나믹스/리듬/편곡) 우선 체계. Easy/Expert 인터뷰, 가사 자동 생성(가사 밀도/길이 통제, 언어 비율 가이드), 듀엣/그룹 보컬, 참고곡 분석(텍스트·YouTube URL·로컬 MP3) 지원 | /music-generator [가사 텍스트] [--instrumental] [--genre <genre>] [--mood <mood>] [--out <path>] ... (대표 옵션 일부) |
| agent-supervisor | 에이전트 행동 진단 — 최근 Claude Code 세션 기록을 읽어 예절·말투/규율·정직을 S/A/B/C/D로 채점(커스텀 심사관 서브에이전트, read-only). 수집 단계 선마스킹, 진단 이력 추이 비교, 항목별 3갈래(의도/수정/오진) 문답 후 ~/.claude/rules/agent-discipline.md에 멱등 병합. Claude Code 전용(Codex 미지원) | /agent-supervisor [--days 7|3] [--scope global|current] |
| xmultiplan | 런타임 교차 합의 계획 — PLANNER(초안)와 CRITIC(비평)을 서로 다른 런타임에 배정해 APPROVE까지 닫힌 루프(최대 N라운드). 기본값 Codex 초안 + Claude 비평, --planner/--critic/--model/--effort로 역할·모델 가변(--model/--effort 미지정 시 ~/.codex/config.toml 기본값 존중). 외부 호출은 codex exec -s read-only·claude -p, 미가용 시 HOST 인라인 폴백. 다단계(step 2개 이상) 계획에는 step 의존성 그래프(mermaid)와 병렬 실행 Wave 분해를 포함해 집행 주체가 병렬화를 판단할 수 있게 함. 계획 전용 — 결과를 pending approval로 docs/plans/에 저장하고 실행하지 않음 | /xmultiplan [--planner codex|claude] [--critic codex|claude] [--model M] [--effort minimal|low|medium|high|xhigh] [--rounds N] <작업> |
| reauth-docmost | docmost MCP 인증 토큰 갱신 — 로그인된 Chrome 세션의 authToken 쿠키를 로컬 쿠키 저장소에서 복호화(macOS 키체인)해 ~/.claude.json의 docmost Bearer 토큰에 주입하고 재연결을 안내. Claude는 헤더를 직접 읽고, Codex 0.151.0+는 bearer_token_env_var(DOCMOST_MCP_TOKEN)로 셸 환경에서 읽으며 그 값은 ~/.codex/docmost-token.env가 ~/.claude.json에서 파생 — 한 파일만 갱신하면 두 런타임 공통 적용. 만료 토큰·동일 토큰·미구성 서버는 게이트로 차단하고, 원자적 교체 + 타임스탬프 백업 + 토큰 마스킹. docmost가 401/토큰 만료 오류를 낼 때 자동 트리거. Claude·Codex 모두 지원 | /reauth-docmost [--dry-run] |
스킬 사용
Claude Code에서 슬래시 커맨드로 호출:
# 브랜치 변경사항 리뷰 (기본)
/multi-review
# 특정 파일 리뷰
/multi-review src/auth.ts src/api.ts
# 워크스페이스 전체 리뷰
/multi-review --workspace
# 스테이징된 변경만 리뷰
/multi-review --staged
# 현재 브랜치 PR의 Copilot 리뷰 처리 (사이클 1부터 시작, 최대 3사이클 자동 폴링)
/check-github-copilot-review
# 특정 PR의 Copilot 리뷰 처리
/check-github-copilot-review 123
/check-github-copilot-review https://github.com/owner/repo/pull/456
# 사이클 초기화 후 처음부터 다시 시작
/check-github-copilot-review --reset
/check-github-copilot-review 123 --reset
# YouTube URL에서 MP3 다운로드 (기본 ~/mp3에 저장)
/mp3-downloader https://www.youtube.com/watch?v=xxxxx
# 커스텀 경로에 저장
/mp3-downloader https://www.youtube.com/watch?v=xxxxx --out $HOME/Music
# 영상 설명에서 트랙 링크 추출 후 다운로드
/mp3-downloader --extract-from-description https://www.youtube.com/watch?v=xxxxx
# 프론트엔드 면접 연습 (기본 - 연차 입력 후 시작, Graph Mode)
/fe-interview
# 이력서 기반 면접 연습
/fe-interview --resume ./resume.pdf --length medium
# 시니어 레벨 짧은 세션
/fe-interview --level senior --length short
# Classic Mode — knowledge/ 파일 기반 질문 (그래프 없이)
/fe-interview --mode classic --level mid
# 노래 만들기 (인터뷰 모드 - Easy/Expert 선택)
/music-generator
# 가사 직접 제공 (Direct Mode)
/music-generator [Verse 1] 오늘도 너를 떠올려... --genre "K-POP Ballad"
# 인스트루멘탈 (배경음악)
/music-generator --instrumental --genre "Lo-fi Hip Hop" --mood "calm"
# 테스트 모드 (Graph Mode 전용)
# Dry-run: 질문 시퀀스/면접관 배분 검증 (~1분)
/fe-interview --test dry-run --level mid --length short
# Tester Agent: AI가 주니어로 답변, 등급 C-D 나오는지 검증
/fe-interview --test agent:junior --length short
# Tester Agent: AI가 시니어로 답변, 등급 A-S 나오는지 검증
/fe-interview --test agent:senior --length short
# 에이전트 행동 진단 (기본 - 최근 7일 전역 세션)
/agent-supervisor
# 현재 프로젝트 세션만, 3일로 한정
/agent-supervisor --days 3 --scope current
# 런타임 교차 합의 계획 (기본: Codex 초안 → Claude 비평)
/xmultiplan 결제 모듈에 멱등성 키를 도입하는 계획을 세워줘
# 역할을 뒤집어 Claude 초안 → Codex 비평 (기존 ralplan --critic codex와 동치)
/xmultiplan --planner claude --critic codex 캐시 무효화 전략 설계
# Codex 모델·추론 강도 지정, 최대 3라운드
/xmultiplan --model <codex-model> --effort high --rounds 3 결제 재시도 로직 리팩터링 계획
# docmost MCP 토큰 갱신 — 먼저 드라이런으로 무엇이 바뀔지 확인
/reauth-docmost --dry-run
# 실제 주입 (Chrome에 docmost 로그인된 상태여야 함) → 이후 /mcp에서 docmost 재연결
/reauth-docmost
설치
Claude Code로 바로 설치
Claude Code에서 아래 프롬프트를 입력하면 스킬이 즉시 설치됩니다.
심볼릭 링크 방식 — git pull로 항상 최신 상태 유지:
이 저장소(https://github.com/choms0521/my-claude-skills)를 클론하고,
.claude/skills/ 하위 스킬들을 ~/.claude/skills/에 심볼릭 링크로 설치해줘
복사 방식 — 독립적으로 사용, 원본 저장소 불필요:
이 저장소(https://github.com/choms0521/my-claude-skills)의 .claude/skills/ 하위 스킬들을
~/.claude/skills/에 복사해서 설치해줘
Claude Code가 저장소 클론부터 설치까지 알아서 처리합니다.
참고: 심볼릭 링크 방식은
~/.claude/skills/에 동일 이름의 디렉토리가 이미 있으면 실패할 수 있습니다. 기존 디렉토리를 먼저 삭제하도록 프롬프트에 추가하거나, Claude Code가 안내할 때 확인하세요.
수동 설치
이 저장소의 스킬을 모든 프로젝트에서 사용하려면 ~/.claude/skills/에 심볼릭 링크를 생성하거나 직접 복사합니다.
주의: 대상 경로에 이미 일반 디렉토리가 존재하면 심볼릭 링크 생성이 실패합니다. 기존 디렉토리가 있다면 먼저 삭제(
rm -rf ~/.claude/skills/<스킬명>)한 후 실행하세요.
전체 스킬 일괄 설치
# ~/.claude/skills 디렉토리 확인
mkdir -p ~/.claude/skills
# 각 스킬을 심볼릭 링크로 연결
ln -sfn /path/to/my-claude-skills/.claude/skills/multi-review ~/.claude/skills/multi-review
ln -sfn /path/to/my-claude-skills/.claude/skills/check-github-copilot-review ~/.claude/skills/check-github-copilot-review
ln -sfn /path/to/my-claude-skills/.claude/skills/mp3-downloader ~/.claude/skills/mp3-downloader
ln -sfn /path/to/my-claude-skills/.claude/skills/fe-interview ~/.claude/skills/fe-interview
ln -sfn /path/to/my-claude-skills/.claude/skills/persona-builder ~/.claude/skills/persona-builder
ln -sfn /path/to/my-claude-skills/.claude/skills/music-generator ~/.claude/skills/music-generator
ln -sfn /path/to/my-claude-skills/.claude/skills/agent-supervisor ~/.claude/skills/agent-supervisor
ln -sfn /path/to/my-claude-skills/.claude/skills/xmultiplan ~/.claude/skills/xmultiplan
ln -sfn /path/to/my-claude-skills/.claude/skills/reauth-docmost ~/.claude/skills/reauth-docmost
개별 스킬 설치
# multi-review만 설치
ln -sfn /path/to/my-claude-skills/.claude/skills/multi-review ~/.claude/skills/multi-review
# check-github-copilot-review만 설치
ln -sfn /path/to/my-claude-skills/.claude/skills/check-github-copilot-review ~/.claude/skills/check-github-copilot-review
# mp3-downloader만 설치
ln -sfn /path/to/my-claude-skills/.claude/skills/mp3-downloader ~/.claude/skills/mp3-downloader
# fe-interview만 설치
ln -sfn /path/to/my-claude-skills/.claude/skills/fe-interview ~/.claude/skills/fe-interview
# persona-builder만 설치
ln -sfn /path/to/my-claude-skills/.claude/skills/persona-builder ~/.claude/skills/persona-builder
# music-generator만 설치
ln -sfn /path/to/my-claude-skills/.claude/skills/music-generator ~/.claude/skills/music-generator
# agent-supervisor만 설치
ln -sfn /path/to/my-claude-skills/.claude/skills/agent-supervisor ~/.claude/skills/agent-supervisor
# xmultiplan만 설치
ln -sfn /path/to/my-claude-skills/.claude/skills/xmultiplan ~/.claude/skills/xmultiplan
# reauth-docmost만 설치
ln -sfn /path/to/my-claude-skills/.claude/skills/reauth-docmost ~/.claude/skills/reauth-docmost
agent-supervisor 첫 실행 유의사항
agent-supervisor는 다른 스킬과 달리 심사관 서브에이전트를 사용합니다. 설치 후 처음 /agent-supervisor를 실행할 때 다음이 자동으로 일어납니다.
- 심사관 자동 설치: 번들된
agent-supervisor-judge서브에이전트가~/.claude/agents/agent-supervisor-judge.md에 멱등 설치됩니다(관리 마커로 버전 추적). 마커가 없는 파일은 사용자 작성본으로 보고 건드리지 않지만, 관리 마커가 있는 파일은 번들 버전이 바뀌면 파일 전체가 다시 쓰여 수동 편집은 보존되지 않습니다. - 재적재 필요(첫 설치 직후 1회): Claude Code는 서브에이전트를 세션 시작 시 발견하므로, 갓 설치된
agent-supervisor-judge는 같은 세션에서 바로 잡히지 않을 수 있습니다. 이 경우/reload-skills를 실행하거나 세션을 재시작한 뒤 다시/agent-supervisor를 호출하세요. - 산출물 위치: 진단 이력은
~/.claude/.agent-supervisor/history/에, 문답으로 합의한 규칙은~/.claude/rules/agent-discipline.md(관리 마커 구획)에 저장됩니다. 위반이 없으면 규칙 파일은 작성하지 않습니다.
런타임: agent-supervisor는 Claude Code 전용입니다. 세션 JSONL 기록·서브에이전트·
AskUserQuestion에 의존하므로 Codex 런타임에서는 동작하지 않습니다.개인정보: 세션 기록은 수집 단계에서 결정론적 정규식으로 선마스킹(API 키/토큰/이메일/비밀키)된 뒤에만 심사관에 전달되며, 외부 제3자 API로 전송되지 않습니다(in-session 서브에이전트만 사용).
스킬 파일 직접 복사 (심볼릭 링크 대신)
# 저장소 업데이트와 동기화하지 않아도 되는 경우
cp -r /path/to/my-claude-skills/.claude/skills/check-github-copilot-review ~/.claude/skills/
설치 확인
설치 후 Claude Code에서 /fe-interview, /multi-review, /check-github-copilot-review 등을 입력하면 스킬이 로드됩니다.
참고: 심볼릭 링크 방식은 이 저장소를
git pull하면 자동으로 최신 스킬이 반영됩니다.
fe-interview 스킬 상세
개요
Knowledge Graph 기반 적응형 프론트엔드 면접 코치입니다. 121개 개념 노드와 161개 엣지로 구성된 지식 그래프를 탐색하며, 3명의 면접관이 협력하여 면접을 진행합니다.
면접관 페르소나
| 면접관 | 역할 | 담당 영역 |
|---|---|---|
| CTO | 아키텍처·시스템 설계 관점 평가 | System Design, Architecture, Performance |
| 팀리드 | 실무 협업·코드 품질 관점 평가 | React, Testing, Accessibility, Next.js |
| 시니어 개발자 | 기초·심화 기술 관점 평가 | JavaScript, HTML/CSS, TypeScript, Security |
두 가지 모드
- Graph Mode (기본):
_graph.json지식 그래프를 탐색하며 동적 질문 생성. 적응형 난이도 조절, 꼬리질문, 크로스 토픽 질문 지원 - Classic Mode (
--mode classic):knowledge/디렉토리의 마크다운 파일에서 직접 질문. 그래프 없이 간단하게 사용
세션 길이
| 길이 | 질문 수 | 예상 소요 시간 |
|---|---|---|
| short | 5-7문제 | ~20분 |
| medium (기본) | 10-12문제 | ~40분 |
| long | 15-18문제 | ~60분 |
평가 체계
각 질문에 대해 S/A/B/C/D 등급으로 평가하고, 세션 종료 후 3명 면접관이 합의하여 종합 리포트를 생성합니다:
- 카테고리별 강점/약점 분석
- 개선 우선순위 로드맵
- 추천 학습 자료
테스트 모드 (Graph Mode 전용)
스킬의 질문 품질과 평가 정확도를 검증하기 위한 자동화 모드입니다:
- Dry-run (
--test dry-run): 답변 없이 질문 시퀀스, 면접관 배분, 그래프 탐색 경로만 검증 (~1분) - Tester Agent (
--test agent:junior|mid|senior): AI가 지정된 레벨로 답변하며 전체 프로세스 검증 (~10-20분)
파일 구조
.claude/skills/fe-interview/
├── SKILL.md # 스킬 정의 (891줄)
├── graph/
│ ├── _graph.json # 지식 그래프 (121노드, 161엣지)
│ ├── nodes/**/*.json # 노드별 상세 (11개 카테고리)
│ ├── roles/*.json # 면접관 역할 정의
│ └── history/session-log.json # 세션 이력 (로컬 전용)
├── knowledge/ # 카테고리×레벨별 질문 파일 (39개)
└── scripts/
├── graph-cli.py # 그래프 관리 CLI
└── update_knowledge.sh # 질문 현황 확인
fe-interview 단독 설치
fe-interview만 별도로 설치하는 3가지 방법입니다.
방법 1: Installer 문서로 자동 설치
fe-interview-installer.md를 Claude Code에 전달하면 저장소 클론부터 전역 심볼릭 링크 설치까지 자동으로 처리됩니다:
fe-interview-installer.md 파일을 읽고 그 안의 지시대로 fe-interview 스킬을 설치해줘
방법 2: 심볼릭 링크 (저장소 클론 후)
ln -sfn /path/to/my-claude-skills/.claude/skills/fe-interview ~/.claude/skills/fe-interview
방법 3: 직접 복사
cp -r /path/to/my-claude-skills/.claude/skills/fe-interview ~/.claude/skills/
참고: fe-interview는
graph/,knowledge/,scripts/하위 디렉토리를 모두 포함하므로 SKILL.md만 복사하면 동작하지 않습니다. 디렉토리 전체를 복사하세요.
persona-builder 단독 설치
persona-builder는 SKILL.md 단일 파일로 구성되어 있어 curl 한 줄로 설치할 수 있습니다.
방법 1: curl로 바로 설치
mkdir -p ~/.claude/skills/persona-builder && \
curl -fsSL -o ~/.claude/skills/persona-builder/SKILL.md \
"https://raw.githubusercontent.com/choms0521/my-claude-skills/main/.claude/skills/persona-builder/SKILL.md"
방법 2: Claude Code에 붙여넣기
아래 텍스트를 Claude Code에 그대로 붙여넣으면 자동으로 설치됩니다:
아래 명령어를 실행해서 persona-builder 스킬을 설치해줘:
mkdir -p ~/.claude/skills/persona-builder && curl -fsSL -o ~/.claude/skills/persona-builder/SKILL.md "https://raw.githubusercontent.com/choms0521/my-claude-skills/main/.claude/skills/persona-builder/SKILL.md"
설치 후 ls ~/.claude/skills/persona-builder/SKILL.md 로 확인해줘
업데이트: 같은 curl 명령을 다시 실행하면 최신 버전으로 덮어씁니다.
제거: rm -rf ~/.claude/skills/persona-builder
music-generator 단독 설치
music-generator는 SKILL.md 단일 파일로 구성되어 있어 curl 한 줄로 설치할 수 있습니다.
사전 요구사항: mmx CLI가 설치되어 있어야 합니다. (
npm install -g mmx또는 공식 문서 참조)
방법 1: curl로 바로 설치
mkdir -p ~/.claude/skills/music-generator && \
curl -fsSL -o ~/.claude/skills/music-generator/SKILL.md \
"https://raw.githubusercontent.com/choms0521/my-claude-skills/main/.claude/skills/music-generator/SKILL.md"
방법 2: Claude Code에 붙여넣기
아래 텍스트를 Claude Code에 그대로 붙여넣으면 자동으로 설치됩니다:
아래 명령어를 실행해서 music-generator 스킬을 설치해줘:
mkdir -p ~/.claude/skills/music-generator && curl -fsSL -o ~/.claude/skills/music-generator/SKILL.md "https://raw.githubusercontent.com/choms0521/my-claude-skills/main/.claude/skills/music-generator/SKILL.md"
설치 후 ls ~/.claude/skills/music-generator/SKILL.md 로 확인해줘
업데이트: 같은 curl 명령을 다시 실행하면 최신 버전으로 덮어씁니다.
제거: rm -rf ~/.claude/skills/music-generator
스킬 추가 방법
.claude/skills/<새-스킬명>/SKILL.md파일 생성- YAML frontmatter에
name,description,triggers정의 - 실행 프로토콜 작성
- 이 README의 스킬 테이블에 추가
요구사항
- Claude Code CLI
- GitHub CLI (
gh) — check-github-copilot-review 스킬에 필수 - (선택) Codex CLI —
npm install -g @openai/codex(codex review로 직접 호출) - (선택) Antigravity CLI (
agy) — multi-review 스킬의 Gemini 관점 리뷰에 사용. 설치(macOS/Linux 공식):curl -fsSL https://antigravity.google/cli/install.sh | bash(바이너리는~/.local/bin/agy에 설치, PATH 추가 필요). Homebrew(커뮤니티):brew install --cask antigravity-cli. 구 Gemini CLI는 2026-06-18 서비스 종료되어agy로 대체됨.agy는 파일을 직접 수정하는 에이전트형 CLI이므로 스킬이 저장소 바깥 격리 실행 + 읽기 전용 프롬프트 + 외부 워치독 + 비파괴적 백스톱과 함께 호출함 - (자동 설치)
yt-dlp,ffmpeg— mp3-downloader 스킬에 필요 (미설치 시 스크립트가 자동 설치 시도) - (선택) mmx CLI — music-generator 스킬 사용 시 필수
Codex/agy CLI가 미설치된 경우 Claude만 사용하여 동작합니다.