skill-fetch

分类: 测试与安全 | 上传者: girofu | 下载: 0 | 版本: v1.0（最新）
This skill should be used when the user asks to "fetch skill", "install skill", "search for a skill", or when a hook outputs "MISSING EXTERNAL SKILL". Searches 9 registries (SkillsMP, GitHub, Anthropic Skills, ClawSkillHub, skills.sh, PolySkill, SkillHub, Skills Directory) with multi-variant search, quality scoring, security labels, pagination, and local/global installation.
更新日志: Source: GitHub https://github.com/girofu/skill-fetch
目录结构

当前层级: skills/skill-fetch/
📁 references/
- 📄 interaction-patterns.md 12.8 KB
- 📄 platform-adapters.md 4.0 KB
- 📄 quality-signals.md 5.2 KB
- 📄 search-sources.md 8.6 KB
📁 scripts/
- 📄 fetch-skillhub.sh 800 B
- 📄 fetch-skills-directory.sh 839 B
📄 SKILL.md 17.7 KB
SKILL.md

---
name: skill-fetch
description: >
  This skill should be used when the user asks to "fetch skill", "install skill",
  "search for a skill", or when a hook outputs "MISSING EXTERNAL SKILL".
  Searches 9 registries (SkillsMP, GitHub, Anthropic Skills, ClawSkillHub, skills.sh,
  PolySkill, SkillHub, Skills Directory) with multi-variant search, quality scoring,
  security labels, pagination, and local/global installation.
allowed-tools: ["Bash", "Read", "Write", "Edit", "Glob", "WebFetch", "shell", "read_file", "write_file", "execute_command", "fetch", "curl"]
---

# Skill Fetch

Search, score, and install agent skills from multiple registries in parallel.

## When to Use

- A skill-eval hook outputs "MISSING EXTERNAL SKILL"
- The current task requires domain expertise not available locally
- The user asks to "fetch skill", "search for a skill", or "install a skill"

## Critical Rules

1. **Never use `skillsmp_get_skill_content` to preview before deciding** — search descriptions are sufficient. Only use as a fallback if installation fails.
2. **Stop on first results, continue only on zero** (max 5 rounds) — any round with ≥1 result proceeds to analysis.
3. **Only the user can decide to skip** — the LLM must never skip installation on its own.
4. **Always use plain-text interaction** — do not use AskUserQuestion. Output analysis and wait for the user to reply with a number or command.
5. **Show up to 5 results per page** — with full analysis (content, pros, cons, repo URL) so the user can make an informed decision.

## Platform Compatibility

This skill works across multiple AI coding agents. Use the platform-appropriate tool:

| Operation | Claude Code | Cursor | Codex | Gemini CLI | Windsurf | Amp |
|-----------|-------------|--------|-------|------------|----------|-----|
| Read file | `Read` | `read_file` | `read_file` | `ReadFile` | `read_file` | `ReadFile` |
| Write file | `Write` | `write_to_file` | `write_file` | `WriteFile` | `write_to_file` | `WriteFile` |
| Edit file | `Edit` | `replace_in_file` | `patch_file` | `EditFile` | `replace_in_file` | `EditFile` |
| Search files | `Glob` | `list_files` | `glob` | `ListFiles` | `list_files` | `Glob` |
| Run command | `Bash` | `execute_command` | `shell` | `RunCommand` | `execute_command` | `Shell` |
| Web fetch | `WebFetch` | `fetch` | N/A | `WebFetch` | `fetch` | N/A |
| Ask user | Plain text output | Plain text output | Plain text output | Plain text output | Plain text output | Plain text output |

> **Note:** If a tool is marked N/A, use `Bash`/`shell` with `curl` as fallback.
> **Auto-detection:** The skill adapts automatically — use whichever tool names your agent provides.

## Procedure

### Step 0: SkillsMP MCP Self-Check (Claude Code only)

Before searching, verify that the SkillsMP MCP server is available:

1. Check if any `skillsmp_*` tool is available (e.g., `skillsmp_search`, `skillsmp_ai_search`)
2. If **available** → proceed to Step 1
3. If **not available** → run: `claude mcp add --scope user skillsmp -- npx -y skillsmp-mcp-server`
4. Inform the user: "SkillsMP MCP server has been registered. It will be available after restarting the session. Continuing search with the remaining 7 sources for now."
5. Proceed to Step 1 (SkillsMP sources will be skipped this session, but available in future sessions)

> **Non-Claude Code agents**: Skip this step. SkillsMP tools are Claude Code-specific.

### Step 0.5: Load API Keys (optional)

Some sources (SkillHub, Skills Directory) provide enhanced results with API keys. Check for configuration:

1. Read `~/.claude/skills/.fetch-config.json` (if exists)
2. Expected format:
   ```json
   {
     "SKILLHUB_API_KEY": "sk-sh-...",
     "SKILLS_DIRECTORY_API_KEY": "sk_live_..."
   }
   ```
3. If file exists, use the keys for Sources 8-9 in Step 2
4. If file doesn't exist, Sources 7-8 use CLI (no key needed), Source 9 is skipped
5. To configure: inform the user they can manually create the file

> **Note:** Sources 1-8 work without any API keys. Only Source 9 (Skills Directory) requires a key for access.

### Step 1: Determine Search Keywords and Source

**URL mode:** If `$ARGUMENTS` is a URL (starts with `https://github.com/...` or any `https://`), skip directly to Step 3 installation flow.

**Search mode:**
- **Has `$ARGUMENTS`**: Use directly as search terms
- **No search terms** (auto-triggered): Prefer `Suggested search terms` from hook output, otherwise extract 2-3 queries from task context

### Step 2: Parallel Search — ALL 9 Sources (mandatory)

**⚠️ MANDATORY: You MUST fire ALL 9 sources in a SINGLE message. Do NOT fire only SkillsMP and skip the rest. Do NOT proceed to scoring until all 9 sources have returned or failed.**

**⚠️ COMMON FAILURE MODE: LLM fires sources 1-2 (SkillsMP), gets results, then skips sources 3-9. This is WRONG. SkillsMP results alone are insufficient — GitHub, ClawhHub, skills.sh, and PolySkill contain different skills not indexed by SkillsMP. You MUST fire ALL sources every time.**

Fire these tool calls in ONE parallel batch:

| # | Source | Tool Call | Fallback |
|---|--------|-----------|----------|
| 1 | **SkillsMP AI** | `skillsmp_ai_search` × 3 query variants (parallel) | Skip if MCP unavailable |
| 2 | **SkillsMP keyword** | `skillsmp_search(query)` | Skip if MCP unavailable |
| 3 | **GitHub repos** | `gh search repos "{query}" --json name,description,url,stargazersCount,updatedAt --limit 5 --sort stars` (do NOT append "skill SKILL.md") | `gh search code "{query}" --filename SKILL.md --limit 5` |
| 4 | **Anthropic Skills** | `gh search code "{query}" --repo anthropics/skills --filename SKILL.md --limit 5` | `gh api` tree fallback |
| 5 | **ClawhHub** | `npx -y clawhub search "{query}"` | Skip on failure |
| 6 | **skills.sh** | `WebFetch("https://skills.sh/api/search?q={query}&limit=5")` | `curl -s` via Bash |
| 7 | **PolySkill** | `npx -y @polyskill/cli search "{single_keyword}" --limit 5` (extract most specific single keyword from query — multi-word queries return 0) | Skip on failure (no REST API) |
| 8 | **SkillHub** | If `SKILLHUB_API_KEY` configured: `bash scripts/fetch-skillhub.sh "{query}"` (bundled script). Fallback: check `~/.claude/skills/.fetch-skillhub.sh`, then `npx -y @skill-hub/cli search "{query}" --limit 5` (timeout: 10000) | CLI fallback on failure |
| 9 | **Skills Directory** | If `SKILLS_DIRECTORY_API_KEY` configured: `bash scripts/fetch-skills-directory.sh "{query}"` (bundled script). Fallback: check `~/.claude/skills/.fetch-skills-directory.sh`. **Never use curl directly or WebFetch.** | Skip if no API key |

> See `references/search-sources.md` for detailed parameters, response formats, query variant examples, and curl fallback commands.

**⚠️ POST-SEARCH CHECKLIST (mandatory before proceeding to Step 2.5):**

Before scoring, you MUST confirm which sources were queried. Output this checklist:
```
Sources queried: [1] SkillsMP AI ✅ [2] SkillsMP KW ✅ [3] GitHub ✅/❌ [4] Anthropic ✅/❌ [5] ClawhHub ✅/❌ [6] skills.sh ✅/❌ [7] PolySkill ✅/❌ [8] SkillHub ✅/❌ [9] Skills Dir ✅/❌
```
If sources 3-7 are ALL marked ❌, you have skipped the non-SkillsMP sources — go back and fire them NOW.

**After ALL sources return** → deduplicate (see `references/search-sources.md`) → proceed to Step 2.5.

**Round strategy (max 5 rounds):** The "≥1 result → stop" rule applies to **rounds**, not individual sources. Within a single round, ALL 9 sources must be queried. Only if ALL 9 sources return 0 results in a round should you proceed to the next round with broader keywords. If any source returns ≥1 result in a round, proceed to scoring (do NOT start another round).

### Step 2.5: Scoring and Ranking

Calculate a quality score (0-100) for each deduplicated result. See `references/quality-signals.md` for details.

**Scoring formula:** `Total = Relevance(0-40) + Freshness(0-25) + Community(0-20) + Trust(0-15) + External Bonus(0-5)`

**Supplementary lookup:** For the top 5 results, use `gh api repos/{owner}/{repo} --jq '{pushed_at,stargazers_count}'` to get update time and GitHub stars. Skip lookup for high-star (≥50) results with precisely matching descriptions. Maximum 3 `gh api` calls.

**Grade labels:** `🟢 85+` Strongly Recommended | `🟢 70-84` Recommended | `🟡 55-69` Worth Considering | `🟡 40-54` Marginal | `🔴 <40` Not Recommended

### Step 3: Analyze, Select, Install

#### 3a. Display Comparison Analysis (plain-text)

Sort all deduplicated results by quality score. Maintain the full sorted list. Display 5 per page (1-5, 6-10, 11-15...):

```
🔍 Found {N} relevant skills, showing {start}-{end} of {N}:

{start}. {skill-name} [{source}] 🟢 {score}/100 | ⭐{stars} | Updated: {YYYY-MM}
   📦 {githubUrl or skillsmp URL}
   Content: {what the skill provides}
   Pros: {match with current task, coverage}
   Cons: {limitations or gaps}

{start+1}. {skill-name-2} [{source}] 🟡 {score}/100 | ⭐{stars} | Updated: {YYYY-MM}
   📦 {repo URL}
   ...

...5 items per page...

💡 Recommendation: #{N} {skill-name-X} ({score}/100 🟢)
   Reason: {1-2 sentences explaining why it best fits the need}

---
Reply with a number to install (e.g., `1`), comma-separated for multiple (e.g., `1,3`)
Reply `c` or "continue" to see next 5 ({end+1}-{end+5})
Reply "skip" to end search
```

**Pagination rules:**
- First page shows items 1-5 with recommendation
- User replies `c` or "continue" → show next 5 (6-10), ranking continues, no re-search
- Can keep paging until list is exhausted; last page shows "All {N} results displayed"
- User can reply with a number on any page (numbers are global, e.g., `7` on page 2 = item #7)
- Recommendation is only shown on the first page

**Scoring formula** (see `references/quality-signals.md`):
- Relevance (0-40): LLM judges description-to-task semantic match
- Freshness (0-25): Time since `pushed_at`
- Community (0-20): Star count (log scale)
- Trust (0-15): Source credibility
- External Bonus (0-5): Security/quality signals from PolySkill, SkillHub, Skills Directory

**Analysis principles:**
- Sort by total score descending; break ties by relevance first
- Each header line shows score and color grade (🟢/🟡/🔴)
- Add `⚠️` for skills not updated in 6+ months
- Apply security labels per `references/quality-signals.md` §6: `🔒 Official`, `🔒 Verified`, `⚠️ Partial`, `⚠️ Unverified`, `⚠️ Security Concerns`
- When multiple skills have different strengths, explain the differences so the user can decide

#### 3b. Wait for User Reply

- **Number** (e.g., `1` or `7`) → Install the selected skill (global numbering, works across pages)
- **Multiple** (e.g., `1,3`) → Install multiple skills
- **`c` or "continue"** → Show next 5 results (ranking continues, no re-search)
- **"skip"** → Output `External skill fetch: user chose to skip installation.` and continue task
- **New keywords** → Return to Step 2 and re-search

#### 3c. Choose Installation Location (MANDATORY — must ask before installing)

**⚠️ MANDATORY: Always display this menu and wait for user reply. Never auto-select based on default.**

Before installing, ask the user for installation scope (if not already specified):

```
📦 Install location:
  [G] Global (available to all projects) → ~/.claude/skills/{skill-name}/
  [L] Local (this project only) → .claude/skills/{skill-name}/

👉 Reply G or L to continue.
```

**Installation path reference:**

| Scope | Path | Use Case |
|-------|------|----------|
| Global | `~/.claude/skills/{skill-name}/` | General skills (shared across projects) |
| Local | `{project-root}/.claude/skills/{skill-name}/` | Project-specific skills (travels with repo) |

**Claude Code Skill Discovery order** (first found wins):
1. `{project}/.claude/skills/` — Project local
2. `~/.claude/skills/` — User global

**Cross-platform skill directories:**

| Agent | Global Path | Local Path |
|-------|-------------|------------|
| Claude Code | `~/.claude/skills/{name}/` | `.claude/skills/{name}/` |
| Cursor | `~/.cursor/skills/{name}/` | `.cursor/skills/{name}/` |
| Codex | `~/.codex/skills/{name}/` | `.codex/skills/{name}/` |
| Gemini CLI | `~/.gemini/skills/{name}/` | `.gemini/skills/{name}/` |
| Windsurf | `~/.windsurf/skills/{name}/` | `.windsurf/skills/{name}/` |
| Amp | `~/.amp/skills/{name}/` | `.amp/skills/{name}/` |

**Auto-detection:** Check which agent directories exist and install to the detected agent's path. If multiple agents are detected, ask the user which to install for.

#### 3d. Execute Installation

**SkillsMP source (trust-but-verify):**
1. Use `skillsmp_install_skill` to install. If it doesn't support the target path: use `skillsmp_get_skill_content` to get content → write to target path.
2. **Post-install security scan**: Read the installed `SKILL.md` + `references/` + `scripts/` (if present)
3. Execute security review (Categories A-F per `references/interaction-patterns.md`)
4. Findings found → warn user with details, offer `confirm install` to keep or `remove` to uninstall
5. Clean scan → continue to verification

**GitHub source:**
1. Use `gh api` or `WebFetch` to download all skill files:
   - `SKILL.md` (required — search for `**/SKILL.md`)
   - `references/*.md` (if directory exists)
   - `scripts/*.sh` (if directory exists)
2. **Pre-install security scan (ALL files)**: Scan every downloaded file against Categories A-F (see `references/interaction-patterns.md`)
   - `SKILL.md` → Categories A-F (including prompt injection)
   - `references/*.md` → Categories A-F (prompt injection is equally dangerous in reference docs)
   - `scripts/*.sh` → Categories A-E (extra-strict shell review)
3. If concerns are found → display findings with file, line, and category → wait for `confirm install` or `skip`
4. On clean scan or user confirmation → write all files to `{skill-name}/` at the target path

**Direct URL source:**
1. `WebFetch` to get content (supports raw GitHub URLs, Gist URLs)
2. **Pre-install security scan**: Same Categories A-F as GitHub source
3. If concerns found → display and wait for confirmation
4. On clean scan or confirmation → write to `{skill-name}/SKILL.md` at the target path

#### 3e. Post-Installation Verification

After installation, run the following checks to ensure the skill can be discovered:

1. **File existence check**: Use Glob to confirm `{target-path}/{skill-name}/SKILL.md` exists
2. **Frontmatter check**: Read the first 10 lines of SKILL.md, confirm valid `---` frontmatter (with `name` and `description`)
3. **Conflict check**: Confirm no same-name skill exists at the other installation path (avoid local/global conflicts)
4. **Integrity hash**: Calculate SHA-256 for all installed files (`SKILL.md`, `references/*.md`, `scripts/*.sh`) and record in metadata (see Step 3f)

On verification failure, output specific errors with fix suggestions.

#### 3f. Update Metadata

Read and update `~/.claude/skills/.fetch-metadata.json`:
```json
{
  "skill-name": {
    "source": "skillsmp|github|url",
    "query": "<search terms or URL>",
    "scope": "global|local",
    "path": "<actual installation path>",
    "installedAt": "<ISO>",
    "integrity": {
      "algorithm": "sha256",
      "files": {
        "SKILL.md": "<sha256-hash>",
        "references/example.md": "<sha256-hash>"
      }
    },
    "securityLabel": "Official|Verified|Partial|Unverified|Security Concerns",
    "scanResult": "clean|warnings|concerns"
  }
}
```

**Integrity hash calculation** (cross-platform):
- macOS/Linux: `shasum -a 256 <file> | cut -d' ' -f1`
- Node.js fallback: `node -e "const c=require('crypto');const f=require('fs');console.log(c.createHash('sha256').update(f.readFileSync(process.argv[1])).digest('hex'))" <file>`

**Hash generation**: After all files are written, calculate SHA-256 for every installed file and record in the `integrity.files` map.

**Integrity verification**: When a skill is loaded in a future session, compare current file hashes against recorded hashes. On mismatch:
```
⚠️ Integrity check failed for skill "{skill-name}":
  Modified: SKILL.md (expected: abc123..., actual: def456...)

The skill has been modified since installation. This could be a legitimate edit or tampering.
Continue using this skill? Reply "yes" or "reinstall".
```

#### 3g. Activate and Confirm

1. **Claude Code:** Call `Skill("{skill-name}")` to load and activate
2. **Other agents:** The skill is available immediately after file installation — no activation step needed
3. Inform the user of installed skill name, path, source, and scope
4. Output: "Installed {skill-name}. Ready to use? Reply 'confirm' or 'skip'."
5. Wait for user confirmation before continuing with the original task

### Step 4: Digest Reference Materials

Installed skills may contain a `references/` subdirectory.

1. Use Glob to check for `references/`
2. Only read files **directly relevant to the current task** (check first 30 lines for relevance)
3. Summarize key knowledge for use in subsequent planning
4. Skip if no `references/` exists

After completion, output: `External skill installed successfully: {skill-name}`

## Completion Phrases

- Success: `External skill installed successfully: {name}`
- Skipped: `External skill fetch: user chose to skip installation.`

## Additional Resources

> **Rationalization Table and Red Flags** are in `references/interaction-patterns.md`. Consult when rationalizing skipping steps.

- **`references/interaction-patterns.md`** — Output templates, user reply handling, security review
- **`references/quality-signals.md`** — Quality assessment dimensions, lookup methods, ranking algorithm
- **`references/search-sources.md`** — Source-specific commands, error handling, deduplication rules
- **`references/platform-adapters.md`** — Cross-platform tool mapping, installation paths, fallback strategies
- **`scripts/fetch-skillhub.sh`** — SkillHub API search (reads key from `~/.claude/skills/.fetch-config.json`)
- **`scripts/fetch-skills-directory.sh`** — Skills Directory API search (reads key from config)
登录后下载/点赞/收藏 ❤ 14 | ★ 0
skill-fetch

目录结构

SKILL.md

举报内容

提示
