Claude 스킬 문제 해결사
플러그인은 설치했는데 스킬이 안 보일 때, 설정 파일과 마켓플레이스 캐시를 체계적으로 진단해 해결해 줍니다.
유틸리티중급★ 1,323⑂ 212AI 점수 8/10마지막 업데이트: 2026. 8. 8.
무엇을 해주나
Claude Code에서 플러그인/스킬이 제대로 동작하지 않을 때 원인을 단계별로 찾아 고치도록 도와줍니다.
installed_plugins.json(설치 목록)과settings.json의enabledPlugins(활성 목록) 불일치 탐지- 마켓플레이스 캐시가 오래됐는지(
known_marketplaces.json의lastUpdated기준) 확인 - 진단 스크립트(
diagnose_plugins.py)와 일괄 활성화 스크립트(enable_all_plugins.py) 제공 - Skills(자동 활성)와 Commands(
/명령어호출)의 구조적 차이 설명 - 자주 쓰는
claude plugin ...명령어 치트시트 제공
이런 분께 추천
- 플러그인을 설치했는데 스킬 목록에 뜨지 않아 답답한 분
- 여러 마켓플레이스/플러그인을 관리하는 파워 유저
- 직접 스킬·플러그인을 만들어 배포하는 개발자
활용 예시
- "플러그인 설치했는데 스킬이 안 보여요" → 두 JSON 파일을 비교해
enabledPlugins에 항목이 빠진 것을 찾아내고claude plugin enable명령으로 해결. - "GitHub에 새 스킬을 올렸는데 마켓플레이스에 안 나와요" → 푸시 여부 확인 →
marketplace.jsonJSON 문법 검사 → 캐시 갱신 순으로 점검. - "마켓플레이스에서 옛날 버전이 설치돼요" → 캐시 디렉터리를 삭제하고
claude plugin marketplace update로 재수신.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 daymade/claude-code-skills 의 daymade-claude-code/claude-skills-troubleshooting 폴더를 내 ~/.claude/skills/claude-skills-troubleshooting/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/daymade/claude-code-skills.git /tmp/claude-code-skills && mkdir -p ~/.claude/skills && cp -r /tmp/claude-code-skills/daymade-claude-code/claude-skills-troubleshooting ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다.
- 저장소를 내려받습니다:
git clone https://github.com/daymade/claude-code-skills.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다(스크립트 폴더까지 통째로):
cp -r claude-code-skills/daymade-claude-code/claude-skills-troubleshooting ~/.claude/skills/ - 파일 확인:
ls ~/.claude/skills/claude-skills-troubleshooting/SKILL.md - Claude Code를 재시작합니다.
- "플러그인이 설치됐는데 스킬이 안 보여"처럼 물어보면 스킬이 자동으로 활성화됩니다.
- (선택) 직접 진단하려면 스킬 폴더에서
python3 scripts/diagnose_plugins.py를 실행하세요.
GitHub에서 원본 보기 ↗라이선스: MIT