Agent Skill Finder

AI 코딩 어시스턴트에서 사용할 Agent Skills를 검색하고, 설치하고, 체계적으로 관리한다.

GitHub Copilot / Claude Code / Cursor / Windsurf / Cline

Features • Installation • Usage • Copilot Chat • Settings • Development

Features

🔍 스킬 검색 및 발견

• 100개 이상 스킬을 키워드로 검색 (로컬 & GitHub)
• 다중 키워드 검색 - 이름/경로/설명 기준으로 관련도 스코어링
• 병렬패치 - 최대 50개 동시 로딩으로 고속 검색
• 풀백 검색 - 검색 결과가 0건일 경우, 키워드를 자동으로 줄여 재시도
• 설명 문구 및 카테고리 태그가 포함된 검색 결과
• ⭐ 스타수, 조직(Organization) 배지 표시
• 검색결과에서 바로 설치/미리보기/즐겨찾기 가능

📦 설치 및 관리

• 한번 클릭으로 .github/skills/경로에 자동 설치
• instruction file 자동업데이트(AGENTS.md / copilot-instructions.md / CLAUDE.md)
• 테이블뷰 제공 - 'When to Use' 컬럼이 포함된 스킬 목록
• 'When to Use' 자동추출 - SKILL.md의 ## When to Use섹션에서 자동 파싱
• 설명편집기능 - 우클릭으로 스킬 설명 커스터마이징
• 스킬제거(언인스톨) 지원
• 전체 재설치 - 최신 소스 기준으로 일괄 재설치(인덱스 자동 업데이트 포함)
• 설치 알림 - 🆕 배지, 상태바 표시, 트리뷰 자동 포커스
• 폴더 바로 열기 - 설치된 스킬 디렉토리로 바로 이동
• 인덱스 정합성 체크 - 미등록 스킬을 자동 탐지하고 인덱스 업데이트를 안내

🔧 멀티 툴 지원

• 워크스페이스 내 AI 도구를 자동감지（Cursor, Windsurf, Cline, Claude Code, GitHub Copilot）
• 감지된 도구에 따라 출력 포맷 자동 선택
• 설정을 통해 수동 오버라이드 가능
• 지원 출력 형식:
  • Markdown（AGENTS.md, CLAUDE.md, copilot-instructions.md）
  • Cursor Rules（.cursor/rules/）
  • Windsurf Rules（.windsurfrules）
  • Cline Rules（.clinerules）

🏠 로컬 스킬 관리

• 워크스페이스 내 SKILL.md 자동 감지
• instruction file로 자동 동기화(includeLocalSkills 설정으로 제어)
• 스킬 수동 등록/해제 명령 제공
• 템플릿 기반 신규 스킬 생성

🤖 GitHub Copilot Chat 연동

• @skill 명령으로 채팅에서 바로 제어
• /search, /install, /list, /recommend
• 프로젝트 컨텍스트 기반 스킬 자동 추천

🛠️ MCP 툴 연동

• Agent Mode에서 툴로 자동 사용 가능
• 총 8개 툴 제공: #searchSkills, #installSkill, #uninstallSkill, #listSkills, #recommendSkills, #updateSkillIndex, #webSearchSkills, #addSkillSource
• 신뢰도 배지 표시(🏢 Official / 📋 Curated / 👥 Community)
• 스킬 설치 시 instruction file 자동 업데이트

🌍 다국어 및 UI

• 한국어 / 영어 UI(자동 감지 + 수동 전환)
• Webview 기반 스킬 미리보기
• 즐겨찾기 기능 제공

Installation

VS Code Marketplace

ext install mdrulesdev.agent-skill-finder

또는 VS Code 확장 마켓플레이스(Ctrl+Shift+X)에서 "Agent Skill Finder" 검색

수동 설치 방법

1. Releases에서 .vsix파일 다운로드
2. VS Code에서 Ctrl+Shift+P → Extensions: Install from VSIX...
3. 다운로드한 .vsix파일 선택 후, 설치

Included Skill Sources

💡 Update Index 명령을 실행하면 최신 스킬 목록으로 즉시 업데이트할 수 있다.

Usage

사이드바에서 사용하기

1. 액티비티바에서 돋보기 아이콘 클릭
2. Workspace Skills - 설치된 스킬 및 로컬 스킬 목록
   • ✓ 설치된 스킬 (초록 아이콘 + 소스명 표시)
   • ○ 로컬 스킬 (instruction file 미등록, 노랑 아이콘)
   • 🆕 최근 설치된 스킬 (일시적 배지)
   • 툴바: 📄 Instruction / ➕ 새 스킬 생성 / 🔃 업데이트 / ⚙️ 설정
   • ... 메뉴: 전체 재설치 / 전체 삭제 / 다중 선택
   • 📂 스킬 폴더 열기 (우클릭 메뉴)
3. Remote Skills - 소스별 스킬 탐색
   • ⭐ 즐겨찾기 섹션이 최상단에 표시
   • 소스 정렬 순서: 🏢 Official → ⭐ Curated → 📦 Community
   • ✓ 설치된 스킬은 초록 아이콘으로 표시
   • 리스트에서 원클릭 설치 가능

아이콘 안내

커맨드 팔레트

빠른 시작

1. Ctrl+Shift+P → "Agent Skill Finder: Search Skills"
2. 키워드 입력(예: "pdf", "azure", "git")
3. 스킬 선택 → 작업 선택(Install / Preview / Favorite / GitHub)
4. 완료! instruction file에 자동 등록된다.

검색 팁

📝 검색 결과가 0건일 경우, 키워드를 자동으로 줄여 재시도한다.

Copilot Chat 연동

GitHub Copilot Chat에서 @skill명령으로 스킬을 바로 제어할 수 있다:

@skill /search MCP server      # 스킬 검색
@skill /install github-mcp     # 스킬 설치
@skill /list                   # 설치된 스킬 목록
@skill /recommend              # 프로젝트 기반 추천
@skill what tools for Python?  # 자연어 검색

Copilot Chat 커맨드 목록

💡 검색결과에 Install 버튼이 함께 표시되어 바로 설치할 수 있다.

MCP Tools (Agent Mode)

GitHub Copilot의 Agent Mode에서는 본 기능이 MCP 툴로 자동 등록되어 사용된다.

제공되는 MCP 툴

사용 예시

💬 "Azure 관련 스킬 찾아줘"
   → #searchSkills 자동 실행, 검색 결과 표시

💬 "bicep-mcp 스킬 설치해줘"
   → #installSkill실행, instruction file 자동 업데이트

💬 "GitHub에서 MCP 서버 검색해줘"
   → #webSearchSkills로 GitHub 리포지토리 검색

💬 "이 프로젝트에 추천할 스킬은?"
   → #recommendSkills가 워크스페이스 분석 후 추천

주요 특징

• 🏢 신뢰도 배지 표시: Official / Curated / Community 구분
• 🌟 추천 스킬 제공: 검색 결과 중 최적의 스킬 자동 추천
• 📅 인덱스 상태 표시: 마지막 업데이트 일자 오래된 경우 경고
• ⚙️ 설정 연동: autoUpdateInstruction / includeLocalSkills 설정을 그대로 반영
• 🎯 토큰 효율 최적화: MCP 툴을 통해 실행하여 대화 컨텍스트 사용 최소화

MCP 툴 비활성화 방법

MCP 툴이 필요하지 않는 경우, GitHub Copilot Chat 설정에서 비활성화할 수 있다:

1. Copilot Chat 패널 → ⚙️ 설정 → Tools
2. 'Agent Skill Finder' 관련 툴을 토클 OFF

Settings

💡 설정화면에서는 위 순서대로 표시된다.

출렷 포맷 상세

auto를 선택하면 워크스페이스 내 설정 파일을 기준으로 사용 중인 AI도구를 자동 감지한다.

Instruction File 동기화 방식

autoUpdateInstruction이 활성화된 경우:

1. 스킬 설치/제거 → instruction file 자동 업데이트
2. 로컬 SKILL.md 감지 → instruction file 파일에 자동 추가(includeLocalSkills = true 일 때)
3. 등록/해제 명령 → 로컬 스킬을 수동으로 제어 가능

instruction file에는 관리용 섹션이 자동으로 추가된다:

<!-- skill-finder-START -->

## Agent Skills

- [skill-name](https://github.com/gaebalai/vscode-agent-skill-finder/blob/HEAD/path/to/SKILL.md) - 설명
<!-- skill-finder-END -->

Instruction File 옵션

GitHub Token 설정

⚠️ 중요: GitHub 검색기능을 사용하려면 GitHub Token 설정이 필수이다. 미설정 시, API 레이트 제한(시간당 60회)으로 인해 검색이 쉽게 실패한다.

검색기능을 사용하려면 GitHub Token을 설정하세요:

방법1: VS Code 설정에서 입력

설정 화면에서 Agent Skill Finder: GitHub Token을 찾아 토큰을 입력한다:

{
  "skillFinder.githubToken": "ghp_xxxxxxxxxxxx"
}

👉 GitHub Token 생성(권장스코프: repo, read:org)

방법2: GitHub CLI(권장)

gh auth login

💡 GitHub CLI가 설치되어 있다면 토큰을 자동으로 가져온다. 별도 설정이 필요없다.

Development

# 의존성 설치
npm install

# 컴파일
npm run compile

# 감시 모드 빌드
npm run watch

# 패키지 생성
npm run package

# 린트
npm run lint

디버깅

1. VS Code에서 F5 실행
2. 새 VS Code창에서 확장 기능 테스트
3. 명령 팔레트(Ctrl+Shift+P)에서 Agent Skill Finder명령 실행

Contributing

1. Fork this repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

CC BY-NC 4.0 © gaebalai

• 비상업적 용도의 사용/수정/재배포 가능
• 상업적 이용은 별도 협의 필요

⚠️ 이 콘텐츠는 AI/ML 학습, 데이터마이닝, 기타 분석 목적의 사용을 금지한다.

Related Projects

• anthropics/skills - Official Claude Skills
• github/awesome-copilot - Official Copilot Resources
• ComposioHQ/awesome-claude-skills - Curated Skills List

Author

Jaewoo, Kim (https://github.com/gaebalai)