Skip to content

Commit c71cea7

Browse files
aktsmmaktsmm
committed
feat(skills): Add skill-finder - Full-featured Agent Skills management tool
- Search 235+ skills from 14 repositories (official, curated, community) - Tag-based filtering (#azure #development) - Install skills to local directory - Star/favorite management - Index auto-update from GitHub sources - Similar skill recommendations - PowerShell and Python scripts included
1 parent b1fac0d commit c71cea7

File tree

12 files changed

+5369
-0
lines changed

12 files changed

+5369
-0
lines changed

‎docs/README.skills.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,4 +22,5 @@ Skills differ from other primitives by supporting bundled assets (scripts, code
2222

2323
| Name | Description | Bundled Assets |
2424
| ---- | ----------- | -------------- |
25+
| [skill-finder](../skills/skill-finder/SKILL.md) | Full-featured Agent Skills management: Search 35+ skills, install locally, star favorites, update from sources. Supports tag search (#azure #bicep), category filtering, and similar skill recommendations. | `LICENSE.txt`<br />`README.md`<br />`assets/demo-en.mp4`<br />`assets/demo-ja.mp4`<br />`assets/demo.mp4`<br />`assets/demo.png`<br />`references/skill-index.json`<br />`references/starred-skills.json`<br />`scripts/Search-Skills.ps1`<br />`scripts/search_skills.py` |
2526
| [webapp-testing](../skills/webapp-testing/SKILL.md) | Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs. | `test-helper.js` |

‎skills/skill-finder/LICENSE.txt‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2025 yamapan (https://github.com/aktsmm)
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

‎skills/skill-finder/README.md‎

Lines changed: 277 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,277 @@
1+
# Skill Finder
2+
3+
> Full-featured Agent Skills management: Search, Install, Star, and Update.
4+
>
5+
> フル機能の Agent Skills 管理ツール: 検索・インストール・お気に入り・更新
6+
7+
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
8+
[![GitHub](https://img.shields.io/badge/GitHub-aktsmm-blue?logo=github)](https://github.com/aktsmm)
9+
10+
**Author / 作者**: yamapan ([@aktsmm](https://github.com/aktsmm))
11+
12+
## Features / 機能
13+
14+
- 🔍 **Local Index Search** - Fast offline search from 220+ pre-indexed skills
15+
- 🏷️ **Tag Search** - Search by tags like `#azure #bicep`
16+
- 🌐 **GitHub Search** - Search SKILL.md files on GitHub
17+
- 📦 **Install Skills** - Download skills to local directory
18+
- ⭐ **Star Favorites** - Mark and manage favorite skills
19+
- 📊 **Statistics** - View index stats and category breakdown
20+
- 🔄 **Auto Update** - Update all sources from GitHub
21+
- 💡 **Similar Skills** - Get recommendations based on categories
22+
23+
---
24+
25+
- 🔍 **ローカル検索** - 220 以上のスキルから高速オフライン検索
26+
- 🏷️ **タグ検索** - `#azure #bicep` のようなタグで検索
27+
- 🌐 **GitHub 検索** - GitHub 上の SKILL.md を検索
28+
- 📦 **インストール** - スキルをローカルにダウンロード
29+
- ⭐ **お気に入り** - よく使うスキルをスター管理
30+
- 📊 **統計情報** - インデックスの統計とカテゴリ内訳
31+
- 🔄 **自動更新** - 全ソースを GitHub から更新
32+
- 💡 **類似スキル** - カテゴリベースのおすすめ表示
33+
34+
## How to Use Skills / スキルの使い方
35+
36+
### 1. Install to designated directory / 所定のディレクトリに配置
37+
38+
```bash
39+
~/.github/skills/ # GitHub Copilot
40+
~/.claude/skills/ # Claude Code
41+
```
42+
43+
### 2. Just prompt / プロンプトを指示するだけ
44+
45+
Skill Finder をスキルとして配置後、AI エージェントにスキルを探すよう指示するだけ：
46+
47+
```
48+
「Azure関連のスキルを探して」 → #azure タグで検索
49+
「ドキュメント処理のスキルある？」→ #document で検索
50+
「PDFを扱えるスキルを教えて」 → pdf で検索
51+
```
52+
53+
### Demo / デモ
54+
55+
**日本語デモ:**
56+
57+
https://github.com/user-attachments/assets/c35fe891-a43e-48da-a107-853b41639c8d
58+
59+
**English Demo:**
60+
61+
https://github.com/user-attachments/assets/4cfc7661-fdc8-40d8-8ad5-65bfd745e796
62+
63+
## Quick Start / クイックスタート
64+
65+
### Search / 検索
66+
67+
```bash
68+
# Basic search / 基本検索
69+
python scripts/search_skills.py "pdf"
70+
pwsh scripts/Search-Skills.ps1 -Query "pdf"
71+
72+
# Tag search / タグ検索
73+
python scripts/search_skills.py "#azure #bicep"
74+
pwsh scripts/Search-Skills.ps1 -Query "#azure #development"
75+
76+
# Category filter / カテゴリフィルタ
77+
python scripts/search_skills.py --category development
78+
pwsh scripts/Search-Skills.ps1 -Category "development"
79+
```
80+
81+
### Skill Management / スキル管理
82+
83+
```bash
84+
# Show skill details / スキル詳細表示
85+
python scripts/search_skills.py --info skill-name
86+
pwsh scripts/Search-Skills.ps1 -Info "skill-name"
87+
88+
# Install skill / スキルをインストール
89+
python scripts/search_skills.py --install skill-name
90+
pwsh scripts/Search-Skills.ps1 -Install "skill-name"
91+
92+
# Star/Unstar / お気に入り追加・削除
93+
python scripts/search_skills.py --star skill-name
94+
python scripts/search_skills.py --unstar skill-name
95+
pwsh scripts/Search-Skills.ps1 -Star "skill-name"
96+
```
97+
98+
### Index Management / インデックス管理
99+
100+
```bash
101+
# Update all sources / 全ソースを更新
102+
python scripts/search_skills.py --update
103+
pwsh scripts/Search-Skills.ps1 -Update
104+
105+
# Add new source / 新しいソースを追加
106+
python scripts/search_skills.py --add-source https://github.com/owner/repo
107+
pwsh scripts/Search-Skills.ps1 -AddSource -RepoUrl "https://github.com/owner/repo"
108+
109+
# View statistics / 統計情報表示
110+
python scripts/search_skills.py --stats
111+
pwsh scripts/Search-Skills.ps1 -Stats
112+
```
113+
114+
### Utilities / ユーティリティ
115+
116+
```bash
117+
# List options / オプション一覧
118+
python scripts/search_skills.py --list-categories
119+
python scripts/search_skills.py --list-sources
120+
python scripts/search_skills.py --list-starred
121+
122+
# Find similar skills / 類似スキル検索
123+
python scripts/search_skills.py --similar skill-name
124+
125+
# Check dependencies / 依存関係チェック
126+
python scripts/search_skills.py --check
127+
```
128+
129+
## Command Reference / コマンドリファレンス
130+
131+
| Python | PowerShell | Description |
132+
| ----------------- | ---------------- | -------------------------------- |
133+
| `--info SKILL` | `-Info SKILL` | Show skill details with SKILL.md |
134+
| `--install SKILL` | `-Install SKILL` | Download skill locally |
135+
| `--star SKILL` | `-Star SKILL` | Star a skill |
136+
| `--unstar SKILL` | `-Unstar SKILL` | Remove star |
137+
| `--list-starred` | `-ListStarred` | List starred skills |
138+
| `--similar SKILL` | `-Similar SKILL` | Find similar skills |
139+
| `--stats` | `-Stats` | Show index statistics |
140+
| `--update` | `-Update` | Update all sources |
141+
| `--check` | `-Check` | Check tool dependencies |
142+
| `#tag` in query | `#tag` in query | Filter by category tag |
143+
144+
## Search Flow / 検索フロー
145+
146+
```
147+
1. Local Index → Fast, offline (220+ skills)
148+
ローカル検索 高速・オフライン (220以上のスキル)
149+
↓ not found / 見つからない
150+
2. GitHub API → Search SKILL.md files
151+
GitHub 検索 SKILL.md を検索
152+
↓ not found / 見つからない
153+
3. Web Search → Show search URLs
154+
Web 検索 検索 URL を表示
155+
↓ found good repo / 良いリポジトリ発見
156+
4. Add to Index → --add-source
157+
インデックス追加
158+
```
159+
160+
## Included Sources / 収録ソース
161+
162+
| Source | Type | Description |
163+
| ------------------------------------------------------------------------------------------------- | --------- | --------------------------- |
164+
| [anthropics/skills](https://github.com/anthropics/skills) | Official | Official Claude skills |
165+
| [obra/superpowers](https://github.com/obra/superpowers) | Community | Superpowers for Claude |
166+
| [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) | Awesome | Curated skill list |
167+
| [microsoft/windows-ai-studio-templates](https://github.com/microsoft/windows-ai-studio-templates) | Official | Microsoft AI templates |
168+
| [github/copilot-instructions](https://github.com/github/copilot-instructions) | Official | GitHub Copilot instructions |
169+
| [aktsmm/Agent-Skills](https://github.com/aktsmm/Agent-Skills) | Community | Azure/Development skills |
170+
171+
## Categories / カテゴリ
172+
173+
| ID | EN | JP |
174+
| ----------- | ---------------------- | ---------------- |
175+
| development | Software development | ソフトウェア開発 |
176+
| testing | Testing & QA | テスト |
177+
| document | Document processing | ドキュメント処理 |
178+
| web | Web development | Web 開発 |
179+
| git | Git & version control | Git |
180+
| agents | AI agents | AI エージェント |
181+
| mcp | Model Context Protocol | MCP |
182+
| azure | Azure services | Azure |
183+
| creative | Creative content | クリエイティブ |
184+
| meta | Meta/utility skills | メタスキル |
185+
186+
## Requirements / 必要環境
187+
188+
### Required / 必須
189+
190+
| Tool | Version | Purpose | Install |
191+
| -------------- | ------- | --------------------- | ----------------------------------------- |
192+
| **GitHub CLI** | 2.0+ | Search/install skills | [cli.github.com](https://cli.github.com/) |
193+
| **curl** | Any | Download files | Pre-installed |
194+
195+
### Optional (choose one) / いずれか選択
196+
197+
| Runtime | Version | Script |
198+
| ---------- | ------- | --------------------------- |
199+
| PowerShell | 7+ | `scripts/Search-Skills.ps1` |
200+
| Python | 3.8+ | `scripts/search_skills.py` |
201+
202+
### Setup / セットアップ
203+
204+
```bash
205+
# 1. Install GitHub CLI / GitHub CLI をインストール
206+
# Windows (winget)
207+
winget install GitHub.cli
208+
209+
# macOS (Homebrew)
210+
brew install gh
211+
212+
# Linux (apt)
213+
sudo apt install gh
214+
215+
# 2. Authenticate / 認証
216+
gh auth login
217+
218+
# 3. Verify / 確認
219+
gh --version
220+
curl --version
221+
```
222+
223+
### Check Dependencies / 依存関係チェック
224+
225+
```bash
226+
# Check all at once / 一括チェック
227+
python scripts/search_skills.py --check
228+
pwsh scripts/Search-Skills.ps1 -Check
229+
```
230+
231+
**Expected output / 期待される出力:**
232+
233+
```
234+
✅ gh: installed (version 2.x.x)
235+
✅ curl: installed
236+
✅ All dependencies satisfied
237+
```
238+
239+
### Troubleshooting / トラブルシューティング
240+
241+
| Issue | Solution |
242+
| ----------------------- | ----------------------------------------- |
243+
| `gh: command not found` | Install GitHub CLI and add to PATH |
244+
| `gh auth login` fails | Run `gh auth login` and follow prompts |
245+
| Rate limit exceeded | Wait or authenticate with `gh auth login` |
246+
| curl SSL errors | Update curl or check network/proxy |
247+
248+
## File Structure / ファイル構成
249+
250+
```
251+
skill-finder/
252+
├── SKILL.md # Skill definition / スキル定義
253+
├── README.md # This file / このファイル
254+
├── LICENSE # MIT License
255+
├── assets/
256+
│ └── demo.mp4 # Demo video / デモ動画
257+
├── scripts/
258+
│ ├── search_skills.py # Python script
259+
│ └── Search-Skills.ps1 # PowerShell script
260+
└── references/
261+
├── skill-index.json # Skill index (220+ skills)
262+
└── starred-skills.json # Starred skills
263+
```
264+
265+
## Contributing / 貢献
266+
267+
Found a great skill repository? Add it to the index and submit a PR!
268+
269+
素晴らしいスキルリポジトリを見つけたら、インデックスに追加して PR を送ってください！
270+
271+
## License
272+
273+
MIT - See [LICENSE](LICENSE) for details.
274+
275+
---
276+
277+
© 2025 yamapan ([@aktsmm](https://github.com/aktsmm))

0 commit comments

Comments
 (0)