Skip to content

参考

基于 fockus/claude-skill-find-skill v1.0.1 README 与 SKILL.md 编写。

速查

  • /find-skill <query> flag:--agent --limit --page --all --top N --stats --category
  • /install-skill <source> flag:--target --name --force --dry-run
  • 默认:limit=5、page=1、agent=当前(Claude Code)
  • 安装路径:Claude ~/.claude/skills/、Codex ~/.codex/skills/、OpenCode ~/.config/opencode/command/、Cursor ~/.cursor/commands/
  • 目录~/.claude/skills/find-skill/cache/catalogue.json(4835 条),update-skills-catalogue.sh 手动更新
  • keySKILLSMP_API_KEY~/.claude/skills/find-skill/.envchmod 600

/find-skill 命令

Flag用途默认
<query>搜索词
--agent <name>claude/codex/opencode/cursor/any当前 agent
--limit N每页最多结果数5
--page N分页1
--all显示全部匹配false
--top N全目录按星数取 Top-N
--stats按源与 agent 的目录统计
--category <cat>某分类下全部技能
bash
/find-skill docker                     # 当前 agent、Top 5
/find-skill docker --agent any         # 全目录 4835 个
/find-skill react --agent cursor       # 仅 Cursor 兼容
/find-skill deploy --all               # 全部匹配
/find-skill python --limit 10 --page 2 # 分页
/find-skill --top 20                   # 全目录 Top-20 by stars
/find-skill --stats                    # 目录统计

/install-skill 命令

Flag用途默认
<source>owner/repo、完整 URL、或目录里的名字
--target <list>逗号分隔目标,或 all当前 agent
--name NAME覆盖技能名(mono-repo 选子技能)从 frontmatter 推导
--force覆盖已存在的安装false
--dry-run只打印动作不写文件false
bash
/install-skill fockus/skill-name              # 当前 agent
/install-skill owner/repo --target all        # 全部 4 个 agent
/install-skill mono-repo --name sub-skill     # mono-repo 子技能
/install-skill https://github.com/user/repo   # 完整 URL

14 个源(共 4835 技能)

星数技能数类型
Anthropic105K17官方
ComposioHQ49K31头部精选清单
hesreallyhim39.9K16头部精选清单
skills.sh3999官方目录(Vercel,多 agent)
vercel-labs24K6社区
VoltAgent-subagents15.5K100社区
VoltAgent13K100社区
travisvn10K56社区
BehiSecc8K100社区
alirezarezvani8K3社区
heilcheng3.5K100社区
daymade100社区
mxyhi38社区
SkillsMP API352市场

Agent 兼容分布

Agent兼容技能数原因
claude4835(100%)SKILL.md 是原生格式
codex4835(100%)与 Claude 同 SKILL.md 格式
opencode3913(81%)skills.sh 目录(多 agent)
cursor3913(81%)skills.sh 目录(多 agent)

安装路径与共享文件

共享(4 个 agent 单一真相源):

文件用途
~/.claude/skills/find-skill/cache/catalogue.json4835 技能目录
~/.claude/skills/find-skill/update-skills-catalogue.sh刷新脚本
~/.claude/skills/find-skill/scripts/install-skill.sh通用安装器(带格式转换)
~/.claude/skills/find-skill/.envAPI key

各 agent 原生命令:Claude Code ~/.claude/skills/find-skill/ + ~/.claude/commands/;Codex ~/.codex/skills/;OpenCode ~/.config/opencode/command/;Cursor ~/.cursor/commands/

目录维护

bash
# 手动更新(不自动)
~/.claude/skills/find-skill/update-skills-catalogue.sh

# 挂 cron 每月更新
(crontab -l 2>/dev/null; echo "0 0 1 * * $HOME/.claude/skills/find-skill/update-skills-catalogue.sh") | crontab -

# 看上次更新
date -r "$(cat ~/.claude/skills/find-skill/cache/last_update.txt)"

SkillsMP API key(可选)

离线核心功能不需要 key;key 只影响「实时兜底」与「多 352 条市场技能」:

bash
# 装后随时添加
echo 'export SKILLSMP_API_KEY="smp_YOUR_KEY_HERE"' >> ~/.claude/skills/find-skill/.env
chmod 600 ~/.claude/skills/find-skill/.env

获取:skillsmp.com → GitHub 登录 → Settings → API keys → Create。key 只存本机、chmod 600、不进 git、4 个 agent 共享一份。

卸载

bash
~/.claude/skills/claude-skill-find-skill/uninstall.sh              # 全部 4 agent + 共享缓存
~/.claude/skills/claude-skill-find-skill/uninstall.sh --target opencode  # 仅 OpenCode
~/.claude/skills/claude-skill-find-skill/uninstall.sh --keep-cache       # 保留目录 + key

相邻的技能 CLI

工具职责命令
find-skill发现 + 安装(多 agent、clone 到本地)/find-skill /install-skill
skills.sh分发(拷进项目、可编辑)npx skills@latest add owner/repo
claude plugin托管插件包(只读、自更新)claude plugin marketplace add owner/repo
skills-ref校验(frontmatter + 命名,离线)skills-ref validate ./my-skill

资源链接