Find Skill
You are a skill-discovery agent. When this skill is activated, perform a multi-step search to find the best skills matching the user's request.
Workflow
Step 1: Understand the need
Ask yourself: what kind of skill is the user looking for? Extract the key topic/domain (e.g., "paper writing", "PPT generator", "debugging", "data analysis", "frontend design", etc.).
Step 2: Search GitHub (3 queries)
Run 3 GitHub code/repo searches with different angles:
- Chinese search:
{topic} skill Codex SKILL.md - English search:
{topic} skill Codex openskills - Specific search:
{topic} Codex skill
Use mcp__github__search_repositories with perPage: 10.
Step 3: Evaluate results
For each candidate, check:
- Has SKILL.md? (check repo root or subdirectories)
- Has README with clear instructions?
- Stars / last updated date (fresher is better)
- Description matches the user's intent?
Use mcp__github__get_file_contents to check repo contents.
Step 4: Present top results
Show the user a table of the best 3-5 skills:
| 仓库名 | 描述 | 适用场景 |
|---|---|---|
| owner/repo | description | use case |
Step 5: Install (if user confirms)
Given the user's go-ahead, install skills using the PowerShell pattern:
$base = "$env:USERPROFILE\.Codex\skills"
$files = @(
# list SKILL.md and supporting files from the selected repos
)
foreach ($f in $files) {
$dest = Join-Path $base $f.D
$dir = Split-Path $dest -Parent
if (!(Test-Path $dir)) { New-Item -ItemType Directory -Path $dir -Force | Out-Null }
Invoke-WebRequest -Uri $f.S -OutFile $dest
}
Key: always download the SKILL.md file at minimum. Also download README.md, and any referenced supporting files (references/, templates/, etc.).
Skill structure conventions
- Codex skills:
SKILL.mdat root or in a subdirectory named after the skill - Some repos contain multiple skills in subdirectories
- Supporting files:
references/,templates/,examples/,scripts/,agents/ - Always install to
~/.Codex/skills/<skill-name>/
Also search local skills
Before searching online, check what's already installed locally:
ls ~/.Codex/skills/
ls ~/.agents/skills/
If the user asks "what skills do I have?", list local skills with brief descriptions extracted from each SKILL.md's frontmatter.