如何查找、安装和使用 AI Skills

认识 Skills

理解技能能解决的具体任务，再决定是否加入工作流。先用一个可检查结果的小任务体验，避免一次安装过多技能。

安装 AI 工具

先在所选 AI 工具的官方网站完成安装与账号配置。本站是技能目录；具体安装路径、授权和兼容版本应按工具及技能作者的说明操作。

系统与环境要求

阅读来源文件中列出的操作系统、运行时、依赖与网络要求。若缺少版本信息，先向作者确认，使用独立测试项目验证环境。

快速开始

搜索任务 → 查看详情与来源 → 按工具说明安装 → 用示例输入验证结果。安装成功后记录版本和配置，方便之后复现。

什么是 Agent Skills

Skills 把任务说明、步骤与相关资源组织成可重复使用的能力。详情页能帮助你判断用途，具体执行行为仍需查看来源文件。

查找合适的技能

优先用任务关键词搜索，再按分类缩小范围。Stars 表示来源仓库热度；结合作者、说明、最近同步日期和使用示例判断是否适合。

安装技能

从详情页进入原始仓库，按作者步骤安装。Claude Code 的项目技能可放在 .claude/skills/；OpenClaw 用户可以查看官方 Skills CLI 说明。不同工具的扩展字段并不通用。

调用与使用

给出任务目标、输入和期望输出，并确认工具识别了技能。Claude Code 可用 /skill-name 显式调用；其他工具的调用方式请看对应文档。

管理与更新

记录已安装来源与版本，更新前阅读变更说明。先在测试项目验证，再更新常用工作环境；停用时按工具文档移除对应文件或配置。

技能目录结构

将核心说明放在 SKILL.md，较长的参考材料和示例按用途拆分。让文件路径清楚、资源可访问，减少重复说明。

my-skill/
├── SKILL.md
├── references/
└── scripts/

创建第一个技能

选一个高频且边界明确的任务，写清触发条件、输入、步骤和结果。先手动验证流程，再整理为技能；不要把未经测试的能力写进描述。

SKILL.md 元信息

文件开头用 YAML 提供 name 和 description，随后写 Markdown 操作说明。让描述表达任务与适用场景；完整字段约束见 Agent Skills 规范。

---
name: draft-check
description: Review draft text before publishing.
---
# Draft check
Review the provided text and list suggested corrections.

输入与参数

说明必需输入、可选项、默认值和缺失输入时的处理方式。调用参数与占位符由具体工具定义，应在该工具中逐项验证。

本地测试

准备正常、缺失输入和边界情况的样例，比较结果与预期。记录失败条件、耗时和外部依赖，修正说明后重复验证。

发布与提交

提供 README、示例、版本说明和许可证信息后发布公开仓库。可通过本站提交入口推荐仓库，收录情况以后台处理结果为准。

环境变量

列出运行所需变量的名称、用途和是否必需。示例只使用占位值，将真实密钥交给工具的凭据配置管理，避免写入公开技能文件。

自定义工具

说明技能会使用的命令、脚本或服务，以及它们的输入、输出和失败行为。工具授权按所用 AI 工具配置，并用样例检查每个依赖。

Hooks 与自动化

Hooks 属于工具层的自动化配置；技能格式本身不保证所有工具支持。先查看目标工具文档，明确触发事件、作用范围和失败后的处理。

组合多个技能

把工作流拆成可检查的阶段，明确上一阶段输出和下一阶段输入。为交接设置验证步骤，防止多个技能相互覆盖配置或重复执行。

CLI 命令参考

下列是 OpenClaw 官方 Skills CLI 的查询与检查命令。本站不提供统一的 TopRank 安装 CLI；命令是否可用取决于本地工具版本。

openclaw skills list
openclaw skills check
openclaw skills search "pdf"

API 与 SDK

本站 API/SDK 尚未开放，可登记需求。技能访问外部 API 的认证、限流和错误处理由技能作者说明，不能由目录中的 Stars 推断支持情况。

配置管理

区分个人、项目和团队配置，记录实际生效的范围。修改后用最小任务确认配置加载成功，出现问题时逐项回退。

权限与数据

查看技能要求的文件、网络和执行权限，并按任务需要授权。使用不含真实客户数据的测试输入，确认输出位置和外部服务后再用于实际工作。

性能与可维护性

缩短重复指令，将大段参考内容拆成按需读取的文件。用同一组样例比较修改前后结果、耗时与失败率，保留可靠的版本。

调试步骤

先确认安装位置与文件名称，再检查环境、依赖、授权和工具日志。复现时保留输入、版本和错误信息；向作者反馈前去除密钥与私人数据。

常见问题排查

找不到技能时检查关键词与分类；调用失败时检查工具版本和来源说明；目录信息不一致时提交来源链接。不同问题应分别联系技能作者或本站。

常见问题

收录不代表独立质量评测，适用性和费用取决于技能及其外部服务。离线使用、数量限制与兼容性应查看来源文件和目标工具说明。

目录与排序说明

默认按已收录数据中的 GitHub 仓库 Stars 排序。Stars 属于来源仓库，同一仓库的多个技能可能共享相同数值；它反映仓库关注度，不代表单个技能的安装量或质量评分。