find-skills

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Find Skills

查找技能

Overview

概述

Searches the open agent skills ecosystem and installs matching skills via the Skills CLI (

pnpm dlx skills

). Includes an enrichment script that fetches descriptions from skills.sh for each result, giving users context beyond raw skill names.

When to use: User asks for help with a domain that might have existing skills, wants to browse available skills, or asks to extend agent capabilities.

When NOT to use: User already knows the exact skill and install command, or the task has nothing to do with skill discovery.

搜索开放的Agent技能生态系统，并通过Skills CLI（

pnpm dlx skills

）安装匹配的技能。包含一个增强脚本，可从skills.sh获取每个结果的描述信息，为用户提供超出原始技能名称的上下文内容。

适用场景： 用户询问某领域的相关帮助，而该领域可能已有现成技能；用户想要浏览可用技能；或者用户希望扩展Agent的能力。

不适用场景： 用户已明确知道具体技能和安装命令；或者任务与技能发现完全无关。

Quick Reference

快速参考

Action	Command	Notes
Search skills	`pnpm dlx skills find [query]`	Interactive or keyword search
Enriched search	`node scripts/enrich_find.js "query"`	Adds descriptions from skills.sh
Install skill	`pnpm dlx skills add <source> -s <name> -a claude-code -y`	Default to Claude Code agent
Install globally	`pnpm dlx skills add <source> -s <name> -a claude-code -g -y`	User-level install
Install all skills	`pnpm dlx skills add <source> --all`	All skills, all agents, skip prompts
Multi-agent install	`pnpm dlx skills add <source> -s <name> -a claude-code opencode github-copilot`	Target multiple agents
List repo skills	`pnpm dlx skills add <source> --list`	Preview without installing
List installed	`pnpm dlx skills list`	Project-level; add `-g` for global
Remove skill	`pnpm dlx skills remove <name>`	Interactive if no name given
Check updates	`pnpm dlx skills check`	Shows available updates
Update skills	`pnpm dlx skills update`	Updates all installed
Init new skill	`pnpm dlx skills init <name>`	Scaffolds SKILL.md
Browse online	`https://skills.sh/`	Web catalog

操作	命令	说明
搜索技能	`pnpm dlx skills find [query]`	交互式或关键词搜索
增强搜索	`node scripts/enrich_find.js "query"`	从skills.sh添加描述信息
安装技能	`pnpm dlx skills add <source> -s <name> -a claude-code -y`	默认针对Claude Code Agent
全局安装	`pnpm dlx skills add <source> -s <name> -a claude-code -g -y`	用户级安装
安装所有技能	`pnpm dlx skills add <source> --all`	安装所有技能、适配所有Agent，跳过提示
多Agent安装	`pnpm dlx skills add <source> -s <name> -a claude-code opencode github-copilot`	针对多个Agent安装
列出仓库技能	`pnpm dlx skills add <source> --list`	预览技能而不安装
列出已安装技能	`pnpm dlx skills list`	项目级；添加 `-g` 查看全局技能
移除技能	`pnpm dlx skills remove <name>`	未指定名称时为交互式操作
检查更新	`pnpm dlx skills check`	显示可用更新
更新技能	`pnpm dlx skills update`	更新所有已安装技能
初始化新技能	`pnpm dlx skills init <name>`	生成SKILL.md模板
在线浏览	`https://skills.sh/`	Web技能目录

Common Skill Categories

常见技能分类

Category	Example Queries
Web Development	react, nextjs, typescript, css, tailwind
Testing	testing, jest, playwright, e2e
DevOps	deploy, docker, kubernetes, ci-cd
Documentation	docs, readme, changelog, api-docs
Code Quality	review, lint, refactor, best-practices
Design	ui, ux, design-system, accessibility
Productivity	workflow, automation, git

分类	示例查询关键词
前端开发	react, nextjs, typescript, css, tailwind
测试	testing, jest, playwright, e2e
DevOps	deploy, docker, kubernetes, ci-cd
文档编写	docs, readme, changelog, api-docs
代码质量	review, lint, refactor, best-practices
设计	ui, ux, design-system, accessibility
生产力工具	workflow, automation, git

Common Mistakes

常见错误

Mistake	Correct Pattern
Using `npx skills`	Use `pnpm dlx skills` for consistent package management
Forgetting `-y` on install	Add `-y` to skip interactive confirmation prompts
Vague search terms like "help"	Use specific keywords: "react testing", "pr review"
Not checking skills.sh first	Browse `https://skills.sh/` for curated listings
Installing without reviewing	Check the skill page on skills.sh before installing
Installing without `-a claude-code`	Always specify agent: `-a claude-code` (or target agent)
Using `owner/repo` for private repos	Use SSH URL: `git@github.com:Org/repo.git`
Running enrichment without Node.js	Script requires Node.js with `https` module (built-in)

错误操作	正确做法
使用 `npx skills`	使用 `pnpm dlx skills` 以确保一致的包管理
安装时忘记添加 `-y`	添加 `-y` 以跳过交互式确认提示
使用模糊搜索词如"help"	使用具体关键词："react testing", "pr review"
未先查看skills.sh	浏览 `https://skills.sh/` 获取精选技能列表
未审核就安装	安装前查看skills.sh上的技能详情页面
安装时未指定 `-a claude-code`	始终指定Agent： `-a claude-code` （或目标Agent）
对私有仓库使用 `owner/repo` 格式	使用SSH地址： `git@github.com:Org/repo.git`
未安装Node.js就运行增强脚本	该脚本需要Node.js及内置的 `https` 模块

Delegation

任务委派

Skill search execution: Run
```
pnpm dlx skills find
```
or the enrichment script directly
Skill installation: Run
```
pnpm dlx skills add
```
after user confirms
Detailed skill info: Browse the skill page on skills.sh before recommending

If the
skill-management
skill is available, delegate skill creation, auditing, and validation to it. Otherwise, recommend:
pnpm dlx skills add oakoss/agent-skills -s skill-management -a claude-code -y

If no matching skill is found, offer to help directly and suggest

pnpm dlx skills init

to create a custom skill.

技能搜索执行：直接运行
```
pnpm dlx skills find
```
或增强脚本
技能安装：用户确认后运行
```
pnpm dlx skills add
```
技能详细信息：推荐前先浏览skills.sh上的技能页面

如果
skill-management
技能可用，可将技能创建、审计和验证任务委派给它。否则，推荐执行：
pnpm dlx skills add oakoss/agent-skills -s skill-management -a claude-code -y

如果未找到匹配的技能，可主动提出直接提供帮助，并建议使用

pnpm dlx skills init

创建自定义技能。

References

参考资料

Discovery workflow and search strategies
Enriched search script usage and options
Installing skills from private repositories

发现工作流与搜索策略
增强搜索脚本用法与选项
从私有仓库安装技能