Skip to content

Commit b4b15be

Browse files
aktsmmaktsmm
committed
feat(skills): add skill-finder - search Agent Skills from local index, GitHub, and web
- Search curated local index with 30+ skills from official and community sources - Fallback to GitHub Code Search API for broader discovery - Web search URLs as final fallback - Add new sources with --add-source to grow your index - Filter by category and source - Supports both PowerShell and Python - MIT License, bilingual README (EN/JP) Co-authored-by: yamapan <[email protected]>
1 parent b1fac0d commit b4b15be

File tree

6 files changed

+1416
-0
lines changed

6 files changed

+1416
-0
lines changed

‎skills/skill-finder/LICENSE‎

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: 118 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,118 @@
1+
# Skill Finder
2+
3+
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
4+
[![GitHub](https://img.shields.io/badge/GitHub-aktsmm-blue?logo=github)](https://github.com/aktsmm)
5+
6+
Search and discover Agent Skills from local index, GitHub, and web.
7+
8+
---
9+
10+
## Features / 機能
11+
12+
- **Local Index Search** - Fast, offline-first search from curated index (30+ skills)
13+
- **GitHub API Search** - Fallback to GitHub Code Search API
14+
- **Web Search** - Final fallback with Google/Bing/DuckDuckGo links
15+
- **Index Management** - Add new repositories with `--add-source`
16+
- **Multi-language** - PowerShell and Python scripts
17+
18+
---
19+
20+
## Quick Start / クイックスタート
21+
22+
### PowerShell
23+
24+
```powershell
25+
# Search by keyword / キーワード検索
26+
pwsh skill-finder.ps1 -Query "pdf"
27+
28+
# Filter by category / カテゴリでフィルタ
29+
pwsh skill-finder.ps1 -Category "development"
30+
31+
# Search GitHub too / GitHub も検索
32+
pwsh skill-finder.ps1 -Query "terraform" -SearchExternal
33+
34+
# Add a new source / 新しいソースを追加
35+
pwsh skill-finder.ps1 -AddSource -RepoUrl "https://github.com/owner/repo"
36+
37+
# List options / オプション一覧
38+
pwsh skill-finder.ps1 -ListCategories
39+
pwsh skill-finder.ps1 -ListSources
40+
```
41+
42+
### Python
43+
44+
```bash
45+
# Search by keyword / キーワード検索
46+
python skill-finder.py "pdf"
47+
48+
# Filter by category / カテゴリでフィルタ
49+
python skill-finder.py --category development
50+
51+
# Search GitHub too / GitHub も検索
52+
python skill-finder.py "terraform" --external
53+
54+
# Add a new source / 新しいソースを追加
55+
python skill-finder.py --add-source https://github.com/owner/repo
56+
57+
# List options / オプション一覧
58+
python skill-finder.py --list-categories
59+
python skill-finder.py --list-sources
60+
```
61+
62+
---
63+
64+
## Search Flow / 検索フロー
65+
66+
```
67+
1. Local Index (fast, offline)
68+
↓ not found
69+
2. GitHub Code Search API
70+
↓ not found
71+
3. Web Search URLs
72+
↓ found good repo
73+
4. Add to index with --add-source
74+
```
75+
76+
---
77+
78+
## Pre-indexed Sources / インデックス済みソース
79+
80+
| Repository | Type | Description |
81+
| --------------------------------------------------------------------------------------------- | ------------ | --------------------------- |
82+
| [anthropics/skills](https://github.com/anthropics/skills) | Official | Claude Skills by Anthropic |
83+
| [github/awesome-copilot](https://github.com/github/awesome-copilot) | Official | Copilot resources by GitHub |
84+
| [obra/superpowers](https://github.com/obra/superpowers) | Community | Skills, agents, commands |
85+
| [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) | Awesome List | Curated Claude Skills |
86+
| [K-Dense-AI/claude-scientific-skills](https://github.com/K-Dense-AI/claude-scientific-skills) | Community | Scientific research |
87+
| [lackeyjb/playwright-skill](https://github.com/lackeyjb/playwright-skill) | Community | Browser automation |
88+
89+
---
90+
91+
## Requirements / 必要要件
92+
93+
- **PowerShell 7+** OR **Python 3.8+**
94+
- **GitHub CLI (`gh`)** - Optional, for external search
95+
96+
---
97+
98+
## Files / ファイル構成
99+
100+
| File | Description |
101+
| ------------------ | ----------------------------- |
102+
| `SKILL.md` | Skill definition / スキル定義 |
103+
| `skill-finder.ps1` | PowerShell script |
104+
| `skill-finder.py` | Python script |
105+
| `skill-index.json` | Local index (30+ skills) |
106+
| `LICENSE` | MIT License |
107+
108+
---
109+
110+
## Author / 作者
111+
112+
**yamapan** ([@aktsmm](https://github.com/aktsmm))
113+
114+
---
115+
116+
## License / ライセンス
117+
118+
[MIT License](LICENSE)

‎skills/skill-finder/SKILL.md‎

Lines changed: 155 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,155 @@
1+
---
2+
name: skill-finder
3+
description: Toolkit for searching and discovering Agent Skills from local index and external sources. Supports keyword, category, and source filtering with fallback to GitHub API and web search.
4+
---
5+
6+
# Skill Finder
7+
8+
This skill enables searching and discovering Agent Skills from a curated local index and external sources like GitHub.
9+
10+
## When to Use This Skill
11+
12+
Use this skill when you need to:
13+
14+
- Find skills for a specific task or domain
15+
- Discover example skills to learn from
16+
- Answer "Is there a skill for X?"
17+
- Explore skill repositories and collections
18+
- Add new skill sources to your index
19+
20+
## Prerequisites
21+
22+
- PowerShell 7+ OR Python 3.8+
23+
- GitHub CLI (`gh`) installed for external search
24+
- Internet connection for GitHub API and web search
25+
26+
## Core Capabilities
27+
28+
### 1. Local Index Search
29+
30+
- Fast, offline-first search from curated index
31+
- 45+ pre-indexed skills from major repositories
32+
- Category and source filtering
33+
34+
### 2. External Search
35+
36+
- GitHub Code Search API integration
37+
- Searches `SKILL.md` files across GitHub
38+
- Automatic fallback when local results insufficient
39+
40+
### 3. Web Search
41+
42+
- Provides search URLs for manual exploration
43+
- Google, Bing, and DuckDuckGo links
44+
45+
### 4. Index Management
46+
47+
- Add new repositories as sources
48+
- Register individual skills
49+
- Auto-discover skills from repository structure
50+
51+
## Usage Examples
52+
53+
### Example 1: Basic Search
54+
55+
```powershell
56+
# PowerShell - Search by keyword
57+
pwsh skill-finder.ps1 -Query "pdf"
58+
```
59+
60+
```python
61+
# Python - Search by keyword
62+
python skill-finder.py "pdf"
63+
```
64+
65+
### Example 2: Filter by Category
66+
67+
```powershell
68+
# PowerShell - List available categories
69+
pwsh skill-finder.ps1 -ListCategories
70+
71+
# PowerShell - Search by category
72+
pwsh skill-finder.ps1 -Category "development"
73+
```
74+
75+
```python
76+
# Python - List and search categories
77+
python skill-finder.py --list-categories
78+
python skill-finder.py --category development
79+
```
80+
81+
### Example 3: Search with External Fallback
82+
83+
```powershell
84+
# PowerShell - Search local + GitHub
85+
pwsh skill-finder.ps1 -Query "terraform" -SearchExternal
86+
```
87+
88+
```python
89+
# Python - Search local + GitHub
90+
python skill-finder.py "terraform" --external
91+
```
92+
93+
### Example 4: Add New Source
94+
95+
```powershell
96+
# PowerShell - Add a new repository
97+
pwsh skill-finder.ps1 -AddSource -RepoUrl "https://github.com/owner/repo"
98+
```
99+
100+
```python
101+
# Python - Add a new repository
102+
python skill-finder.py --add-source https://github.com/owner/repo
103+
```
104+
105+
## Guidelines
106+
107+
1. **Start with local search** - Local index is fast and works offline
108+
2. **Use categories for discovery** - Categories help narrow down results
109+
3. **Enable external search** - Use `-SearchExternal` for comprehensive results
110+
4. **Grow your index** - Add useful repositories with `-AddSource`
111+
5. **Check multiple sources** - Use `-ListSources` to see available sources
112+
6. **Update regularly** - Re-run `-AddSource` to update skill listings
113+
114+
## Search Flow
115+
116+
```
117+
1. Local Index (fast, offline)
118+
↓ not found
119+
2. GitHub Code Search API
120+
↓ not found
121+
3. Web Search URLs
122+
↓ found good repo
123+
4. Add to index with --add-source
124+
```
125+
126+
## Indexed Sources
127+
128+
| Repository | Description |
129+
| --------------------------------------------------------------------------------------------- | ------------------------------------- |
130+
| [anthropics/skills](https://github.com/anthropics/skills) | Official Claude Skills by Anthropic |
131+
| [github/awesome-copilot](https://github.com/github/awesome-copilot) | Official Copilot resources by GitHub |
132+
| [obra/superpowers](https://github.com/obra/superpowers) | High-quality skills, agents, commands |
133+
| [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) | Curated Claude Skills list |
134+
| [K-Dense-AI/claude-scientific-skills](https://github.com/K-Dense-AI/claude-scientific-skills) | Scientific research skills |
135+
| [lackeyjb/playwright-skill](https://github.com/lackeyjb/playwright-skill) | Browser automation skill |
136+
137+
## Categories
138+
139+
| ID | Description |
140+
| ----------- | ------------------------------------ |
141+
| development | Software development tools |
142+
| testing | Testing & QA automation |
143+
| document | Document processing & conversion |
144+
| office | Microsoft Office file handling |
145+
| web | Web development & browser automation |
146+
| git | Git & version control |
147+
| agents | AI agents & orchestration |
148+
| mcp | Model Context Protocol |
149+
150+
## Limitations
151+
152+
- GitHub API rate limits may affect external search
153+
- Web search only provides URLs (manual browsing required)
154+
- Some skills may not follow standard SKILL.md format
155+
- Index updates require manual `-AddSource` calls

0 commit comments

Comments
 (0)