| name | finding-skills |
| description | Searches and recommends Claude Code skills and plugins from local database and SkillsMP API. Activates when user asks to find skills, search plugins, get recommendations for PDF/Git/code-review/frontend tools, or requests feature-based tool discovery. |
외부 스킬 찾기
사용자가 원하는 기능이나 목적에 맞는 Claude Code 스킬 및 플러그인을 추천하는 대화형 도우미입니다.
Resources
이 스킬은 다음 리소스를 참조합니다:
- 외부 스킬 데이터베이스:
references/external-skills-database.json - 공식 및 커뮤니티 스킬 정보
- SkillsMP 검색 스크립트:
scripts/search_skills.py - 실시간 커뮤니티 스킬 검색
Instructions
1. 사용자 의도 파악
사용자가 다음과 같은 요청을 할 때 이 스킬이 활성화됩니다:
- "PDF 작업할 수 있는 스킬 있어?"
- "Git 커밋을 도와주는 플러그인 찾아줘"
- "코드 리뷰 자동화 도구 추천해줘"
- "프론트엔드 개발에 유용한 스킬은?"
- 기타 기능이나 목적 기반 스킬 검색 요청
2. 검색 및 분석 프로세스
스킬 검색은 2단계 접근법을 사용합니다:
단계 1: 로컬 데이터베이스 검색
-
키워드 추출: 사용자 요청에서 핵심 키워드 추출 (한글은 영어로 변환)
-
로컬 데이터베이스 조회: references/external-skills-database.json 파일 읽기
- 키워드를 사용해
searchIndex 섹션에서 관련 스킬 찾기
- 카테고리별로 스킬 정보 탐색
- 공식 스킬 및 플러그인 우선 매칭
단계 2: SkillsMP API 검색 (Python 스크립트 사용)
로컬 데이터베이스에서 충분한 결과를 찾지 못했거나, 더 많은 커뮤니티 스킬이 필요한 경우:
-
Python 스크립트 실행: Bash 도구를 사용하여 search_skills.py 스크립트 실행
python3 scripts/search_skills.py "[영어 검색어]" --limit 5
스크립트 옵션:
--limit N: 반환할 결과 수 (기본값: 10, 권장: 5)--page N: 페이지 번호 (기본값: 1)--sort stars|recent|name: 정렬 기준 (기본값: stars)--format json|text: 출력 형식 (기본값: json)
예시:
python3 scripts/search_skills.py "pdf" --limit 5
python3 scripts/search_skills.py "git commit" --limit 5 --sort recent
python3 scripts/search_skills.py "image processing" --limit 5 --format text
-
스크립트 응답 형식 (JSON):
{
"success": true,
"query": "검색어",
"total": 100,
"page": 1,
"totalPages": 10,
"hasNext": true,
"skills": [
{
"name": "스킬 이름",
"author": "작성자",
"description": "스킬 설명",
"stars": 1234,
"githubUrl": "https://github.com/...",
"hasMarketplace": true
}
]
}
-
응답 데이터 처리:
skills 배열에서 각 스킬 정보 추출stars 수로 인기도 판단hasMarketplace가 true이면 마켓플레이스 설치 가능githubUrl에서 저장소 정보 확인
-
결과 병합:
- 로컬 데이터베이스 결과 (공식/큐레이션)
- SkillsMP 스크립트 결과 (커뮤니티/최신)
- 중복 제거 및 관련성 순으로 정렬
검색 전략
-
한글 쿼리: 먼저 영어로 변환 후 검색
- "PDF 작업" → "pdf work" 또는 "pdf"
- "Git 커밋" → "git commit"
- "코드 리뷰" → "code review"
-
복합 검색: 여러 키워드가 있을 경우
- 각 키워드로 개별 검색 후 결과 병합
- 또는 공백으로 구분된 검색어로 API 호출
-
결과 우선순위:
- 로컬 데이터베이스의 공식 스킬
- 로컬 데이터베이스의 공식 플러그인
- SkillsMP의 인기 스킬 (stars 기준)
- 로컬 데이터베이스의 커뮤니티 리소스
매칭 및 필터링
- 최종적으로 3-5개의 가장 관련성 높은 스킬 선별
- 각 스킬의 features, useCases, 인기도 확인
- 다양한 옵션 제공 (공식 vs 커뮤니티)
3. 응답 형식
사용자에게 다음 정보를 제공합니다:
기본 정보
## 추천 스킬: [스킬 이름]
**설명**: [스킬 설명]
**제공자**: [공식/커뮤니티/작성자]
**인기도**: ⭐ [stars 수] (SkillsMP API에서 온 경우)
**태그**: [관련 태그들]
SkillsMP API 결과의 경우 추가 정보:
- stars 수를 표시하여 인기도 표시
- marketplace 정보가 있으면 해당 마켓플레이스 명시
- author/owner 정보 표시
주요 기능
스킬의 주요 기능을 카테고리별로 나열:
### 주요 기능
**[카테고리 1]**
- 기능 1
- 기능 2
**[카테고리 2]**
- 기능 3
- 기능 4
설치 방법
로컬 데이터베이스 스킬의 경우:
### 설치 방법
\`\`\`bash
[설치 명령어들]
\`\`\`
[추가 설명이 있다면 포함]
SkillsMP API 스킬의 경우:
### 설치 방법
[marketplace 정보가 있는 경우]
\`\`\`bash
/plugin marketplace add [marketplace-owner]/[marketplace-repo]
/plugin install [skill-name]@[marketplace-name]
\`\`\`
[marketplace 정보가 없는 경우]
GitHub 저장소를 참고하여 수동 설치하거나 로컬에서 사용하세요:
- 저장소: [repository URL]
사용 사례
### 이런 경우에 유용합니다
- 사용 사례 1
- 사용 사례 2
- 사용 사례 3
추가 정보
### 더 알아보기
- **저장소**: [GitHub URL]
- **관련 문서**: [문서 링크]
4. 다중 스킬 추천
여러 스킬이 관련될 경우:
- 가장 적합한 스킬을 먼저 소개
- 관련된 다른 스킬들도 간략히 언급
- 사용자가 선택할 수 있도록 옵션 제시
5. 검색 결과 없음
로컬 데이터베이스와 SkillsMP API 모두에서 관련 스킬을 찾지 못한 경우:
죄송합니다. "[검색어]"와 관련된 스킬을 찾을 수 없습니다.
다음을 시도해보세요:
- 다른 키워드로 검색 (영어로 시도해보세요)
- Claude Code 마켓플레이스 확인: `/plugin marketplace list`
- SkillsMP 웹사이트 직접 검색: https://skillsmp.com
- GitHub에서 "claude-code" 토픽 검색: https://github.com/topics/claude-code
예시
예시 1: PDF 관련 스킬 검색 (로컬 DB)
사용자: "PDF 파일 작업할 수 있는 스킬 있어?"
검색 과정:
- 로컬 데이터베이스에서 "pdf" 키워드로 검색
- example-skills가 매칭됨
응답:
## 추천 스킬: example-skills
**설명**: Anthropic에서 제공하는 공식 예제 스킬 모음입니다.
**제공자**: Anthropic (공식)
**태그**: official, documents, frontend, development-tools
### 주요 기능
**문서 작업**
- PDF 파일 생성/편집/분석
- DOCX 문서 생성/편집
- PPTX 프레젠테이션 생성/편집
- XLSX 스프레드시트 생성/편집
**프론트엔드**
- React 컴포넌트 디자인
- 알고리즘 아트 생성 (p5.js)
- 캔버스 디자인
- 웹 아티팩트 빌더
**개발 도구**
- MCP 서버 빌더
- 웹앱 테스팅 (Playwright)
- 스킬 생성기
### 설치 방법
\`\`\`bash
/plugin marketplace add anthropic/example-skills
/plugin install example-skills@anthropic-agent-skills
\`\`\`
설치 후 개별 스킬을 바로 사용할 수 있습니다.
### 이런 경우에 유용합니다
- 문서 자동화가 필요한 프로젝트
- 프론트엔드 컴포넌트 빠른 프로토타이핑
- MCP 서버 개발
- 비주얼 콘텐츠 생성
### 더 알아보기
- **저장소**: https://github.com/anthropics/anthropic-agent-skills
예시 2: Git 관련 스킬 검색
사용자: "Git 커밋 자동화 도구 추천해줘"
응답:
Git 커밋 관련해서 두 가지 좋은 옵션이 있습니다:
## 1. commit-commands (공식 플러그인)
**설명**: Git 작업을 간소화하는 커밋 관련 명령어 모음
**제공자**: Claude Code Official
### 주요 기능
- `/commit` - 스마트 커밋 메시지 생성
- `/commit-push-pr` - 커밋, 푸시, PR 생성 일괄 처리
- `/clean_gone` - 삭제된 원격 브랜치 정리
### 설치 방법
\`\`\`bash
/plugin install commit-commands@claude-plugins-official
\`\`\`
---
## 2. git-workflow (이 저장소의 플러그인)
**설명**: 변경 사항을 논리적 단위로 자동 분석하여 커밋
**제공자**: jeongsk
### 주요 기능
- 변경 사항을 논리적 단위로 자동 그룹화
- 의미 있는 커밋 메시지 자동 생성
- 단계별 커밋 또는 일괄 커밋 & 푸시
### 설치 방법
\`\`\`bash
/plugin marketplace add jeongsk/claude-skills
/plugin install git-workflow@jeongsk-claude-skills
\`\`\`
어떤 스킬이 더 필요하신지 알려주시면 자세한 사용법을 안내해드리겠습니다!
예시 3: SkillsMP 스크립트를 활용한 검색
사용자: "Obsidian 관련 스킬 찾아줘"
검색 과정:
- 로컬 데이터베이스에서 "obsidian" 키워드 검색 → 결과 없음
- Python 스크립트 실행:
python3 scripts/search_skills.py "obsidian" --limit 5
- 스크립트 응답에서 인기 스킬 추출
스크립트 출력 예시:
{
"success": true,
"query": "obsidian",
"total": 37,
"page": 1,
"totalPages": 4,
"hasNext": true,
"skills": [
{
"name": "obsidian-vault-ops",
"author": "ballred",
"description": "Read and write Obsidian vault files, manage wiki-links, process markdown with YAML frontmatter.",
"stars": 734,
"githubUrl": "https://github.com/ballred/obsidian-claude-pkm/tree/main/vault-template/.claude/skills/obsidian-vault-ops",
"hasMarketplace": false
},
{
"name": "obsidian",
"author": "gapmiss",
"description": "Comprehensive guidelines for Obsidian.md plugin development including ESLint rules, TypeScript best practices.",
"stars": 16,
"githubUrl": "https://github.com/gapmiss/obsidian-plugin-skill/tree/main/.claude/skills/obsidian",
"hasMarketplace": false
}
]
}
응답:
"obsidian"으로 SkillsMP에서 검색한 결과입니다:
## 1. obsidian-vault-ops
**설명**: Obsidian vault 파일 읽기/쓰기, wiki-links 관리, YAML frontmatter 처리
**제공자**: ballred (커뮤니티)
**인기도**: ⭐ 734
### 설치 방법
GitHub 저장소를 참고하여 수동 설치:
- **저장소**: https://github.com/ballred/obsidian-claude-pkm
---
## 2. obsidian
**설명**: Obsidian.md 플러그인 개발을 위한 종합 가이드라인
**제공자**: gapmiss (커뮤니티)
**인기도**: ⭐ 16
### 설치 방법
GitHub 저장소를 참고하여 수동 설치:
- **저장소**: https://github.com/gapmiss/obsidian-plugin-skill
더 많은 결과는 SkillsMP에서 확인하세요: https://skillsmp.com
참고사항
데이터 소스
- 로컬 데이터베이스: 정기적으로 업데이트됩니다 (
lastUpdated 필드 확인)
- SkillsMP API: 실시간 커뮤니티 스킬 정보 제공
- 공식 스킬은 Anthropic 및 Claude Code Official에서 관리
- 커뮤니티 스킬은 개별 개발자가 관리
SkillsMP 스크립트 주의사항
- 검색어는 영어로 사용 (한글은 영어로 변환 후 실행)
- 로컬 DB 우선 검색 후 스크립트 보조 사용
- 중복 결과 필터링 필요
- 상세 사용법은 "단계 2: SkillsMP API 검색" 참조
추가 기능
카테고리별 탐색
사용자가 "전체 스킬 목록 보여줘" 또는 "카테고리별로 보여줘" 요청 시:
- 데이터베이스의
categories 섹션 읽기
- 각 카테고리별로 스킬 요약 제공
- 사용자가 관심 있는 카테고리 선택 가능
태그 기반 검색
사용자가 특정 태그로 검색 요청 시:
official, development, git, documents 등의 태그로 필터링- 해당 태그를 가진 모든 스킬 나열
오류 처리
로컬 데이터베이스 오류
- 파일을 읽을 수 없는 경우: 사용자에게 README 참조 안내
- JSON 파싱 오류: 관리자에게 문제 보고 요청
SkillsMP 스크립트 오류
- 스크립트 실행 실패: 로컬 데이터베이스 결과만 표시
"success": false 응답: error 메시지 확인 후 무시하고 계속 진행- 타임아웃: "SkillsMP 검색이 응답하지 않습니다. 로컬 결과만 표시합니다." 메시지
- Python 미설치: 스크립트 사용 불가 안내, 로컬 DB만 사용
빈 검색 결과
- 로컬 DB와 API 모두 결과 없음: 대체 검색 방법 제안
- 영어로 재시도 권장
- SkillsMP 웹사이트 직접 방문 안내
