AI 代理技能库

我精心整理的代理技能库，以及用于构建您自己的包。

这是我实际使用的技能集合，按照我的工作方式组织。

_{17 个本地副本 · 47 个已编目上游技能}

手工挑选、分类并维护。

构建您自己的技能库 · 为您的代理准备

技能库

ai-agent-skills 提供两项功能。

它不仅包含我精心整理的技能库，还提供了用于构建和管理您自己技能库的 CLI 和 TUI。该工具可与任何兼容 Agent Skills 的代理配合使用。

随附的技能库按照我的工作方式组织：

• 从 frontend 或 workflow 等架子开始
• 保持技能集足够小，便于快速浏览
• 保留清晰的来源信息
• 添加注释，解释为何将某项技能放入其中

如果您需要广泛的生态系统支持，请使用 skills.sh；而当您希望拥有一个包含架子、来源信息和注释的小型技能库时，则应选择 ai-agent-skills。

4.0.0 版本的新特性

• 使用 init-library 管理技能库工作空间
• 新增 add <source> 命令，用于将内置精选、上游仓库中的技能或本地副本引入您的技能库
• 将 sync [name] 设为主要的更新命令，update 仍作为别名保留
• 具备依赖感知的安装功能，支持 requires 和 --no-deps
• 在 CLI 和 TUI 中均可查看已安装状态

当前状况

我在 2025 年 12 月 17 日发布了此项目，当时 skills.sh 尚未出现，生态系统也尚未形成明确的默认通用安装程序。

最初，这个仓库就是那个安装程序。如今它仍然承担这一职责。

原本作为安装程序起步的项目，如今已成为构建和管理您个人技能库的场所。

工作原理

这里的每项技能要么是本地副本，要么是从上游仓库中精选并编目的版本。

• 本地副本 存放在 skills/<name>/ 下的本地文件夹中。这些技能安装迅速，可在离线状态下使用，并随 npm 包一起分发。

• 已编目上游 存在于 skills.json 中的元数据，无本地文件夹。这些技能保留在上游，当您请求时会直接从源仓库安装。

上游工作始终保留在上游，从而确保技能库的精简性。

为您的代理准备

请让您的代理为您构建一个技能库。您可以粘贴以下内容，或者直接指向此仓库——下方的协议包含了所需的一切。

完整的协议及策展决策框架：FOR_YOUR_AGENT.md

将以下内容粘贴到您的代理中

帮我用 `ai-agent-skills` 设置一个受管理的团队技能库。

在开始之前，请先阅读完整的代理协议：
https://raw.githubusercontent.com/MoizIbnYousaf/Ai-Agent-Skills/main/FOR_YOUR_AGENT.md

请使用 `npx` 命令行工具操作。如果已有相应命令，请勿手动编辑 `skills.json`、`README.md` 或 `WORK_AREAS.md`。

1. 获取并阅读上述 FOR_YOUR_AGENT.md 文件——其中包含完整的策展决策协议。
2. 使用 `npx ai-agent-skills init-library <name>` 创建一个工作空间。
3. 向我提出最多三个简短的问题：您希望处理的工作类型是小型还是广泛？是本地草稿还是共享仓库？
4. 将我的技术栈映射到各个架子上：前端、后端、移动端、工作流、代理工程。
5. 运行发现循环：`list --area <shelf>`、`search <query>`、`collections`。
6. 每次添加技能时，都需明确指定 `--area`、`--branch` 和 `--why` 参数，每次添加 3 到 8 项技能。
7. 完成前运行 `npx ai-agent-skills build-docs`。
8. 如果我希望共享此库：`git init && git add . && git commit -m "初始化技能库" && gh repo create`。
9. 告诉我您添加了哪些技能、它们属于哪个架子，以及队友可以用来安装的命令。

配套的工作流程技能（使用技能库时会自动安装）：

npx ai-agent-skills install install-from-remote-library
npx ai-agent-skills install curate-a-team-library
npx ai-agent-skills install share-a-library
npx ai-agent-skills install browse-and-evaluate
npx ai-agent-skills install update-installed-skills
npx ai-agent-skills install build-workspace-docs
npx ai-agent-skills install review-a-skill
npx ai-agent-skills install audit-library-health
npx ai-agent-skills install migrate-skills-between-libraries

快速入门

使用内置技能库

# 打开终端浏览器
npx ai-agent-skills

# 列出所有架子
npx ai-agent-skills list

# 从技能库中安装一项技能
npx ai-agent-skills install frontend-design

# 将 Swift 中心安装到默认全局目标
npx ai-agent-skills swift

# 安装整个精选包
npx ai-agent-skills install --collection swift-agent-skills -p

# 安装到项目架子上
npx ai-agent-skills install pdf -p

# 将上游仓库中的所有技能安装到默认全局目标
npx ai-agent-skills anthropics/skills

# 在添加或安装之前先浏览某个仓库
npx ai-agent-skills install openai/skills --list

默认安装目标：

• 全局：~/.claude/skills/
• 项目：.agents/skills/

通过 --agent <name> 参数，仍可使用旧版特定于代理的目标。

开始构建您自己的技能库

# 创建一个受管理的工作空间
npx ai-agent-skills init-library my-library
cd my-library

# 添加一项内置精选技能，安装、刷新并重新构建文档
npx ai-agent-skills add frontend-design --area frontend --branch Implementation --why "我想把它放在我的架子上。"
npx ai-agent-skills install frontend-design -p
npx ai-agent-skills sync frontend-design -p
npx ai-agent-skills add anthropics/skills --skill webapp-testing --area workflow --branch Testing --why "我在工作区需要进行浏览器级别的检查时会用到它。"
npx ai-agent-skills build-docs

工作区模式

工作区模式现在已成为正常流程的一部分。

从一个受管的工作区开始，添加几个技能，然后使用 add、catalog、vendor、sync 和 build-docs 命令来保持你的货架内容最新。

npx ai-agent-skills init-library my-library
cd my-library

npx ai-agent-skills add frontend-design --area frontend --branch Implementation --why "I want this on my shelf."
npx ai-agent-skills install frontend-design -p
npx ai-agent-skills add anthropics/skills --skill webapp-testing --area workflow --branch Testing --why "I use this when I want browser-level checks in the workspace."
npx ai-agent-skills sync frontend-design -p
npx ai-agent-skills build-docs

工作流指南：

• 创建库
• 添加上游技能
• 制作本地副本
• 整理货架
• 刷新已安装的技能

浏览

大多数浏览操作都始于以下两个地方：

视图	存在原因	从这里开始
货架	理解库的主要方式：先从工作类型入手，再深入到该货架上的精选技能。	npx ai-agent-skills list
来源	源头视图：查看哪些发布者为哪些货架和分支提供内容。	npx ai-agent-skills info frontend-design

其他视图仍然有用，但更多是针对特定场景：

• 使用 npx ai-agent-skills browse 进行 TUI 浏览
• 使用 npx ai-agent-skills list --collection my-picks 获取跨货架的入门技能集合
• 使用 npx ai-agent-skills install --collection swift-agent-skills -p 安装可选的精选包
• 使用 npx ai-agent-skills curate review 处理策展人待处理的任务

货架

货架是主要的结构。

货架	技能数量	涵盖内容
前端	10	界面、设计系统、浏览器相关工作以及产品优化。
后端	5	系统、数据、安全及运行时操作。
移动	24	Swift、SwiftUI、iOS 以及 Apple 平台开发，未来还可扩展 React Native 分支。
工作流	11	文件、文档、计划、发布工作以及研究到产出的流程。
代理工程	14	MCP、技能构建、提示工程规范以及 LLM 应用相关工作。

完整的地图位于 WORK_AREAS.md 中。

收藏集

收藏集是较小的技能集合，虽然有用，但不如货架重要。

收藏集	存在原因	从这里开始
my-picks	一个简短的入门技能集合。这些是我首先会使用的技能。	frontend-design, mcp-builder, pdf
build-apps	用于交付高质量应用的前端、UI 和设计工作。	frontend-design, frontend-skill, shadcn
swift-agent-skills	本库中主要的 Swift 和 Apple 平台技能集合。可以一次性全部安装，也可以从中挑选。	swiftui-pro, swiftui-ui-patterns, swiftui-design-principles
build-systems	后端、架构、MCP 和安全相关工作。	mcp-builder, backend-development, database-design
test-and-debug	QA、调试、CI 清理以及可观ility 相关工作。	playwright, webapp-testing, gh-fix-ci
docs-and-research	文档、文件、研究和写作相关工作。	pdf, doc-coauthoring, docx

策划目录

当你想添加上游技能而不将其纳入本地副本时，可以使用 catalog 命令。

在受管的工作区中，首先使用 add 命令。如果需要更多控制，可以使用 catalog 和 vendor 命令。

npx ai-agent-skills catalog openai/skills --list
npx ai-agent-skills catalog openai/skills --skill linear --area workflow --branch Linear
npx ai-agent-skills catalog openai/skills --skill security-best-practices --area backend --branch Security
npx ai-agent-skills catalog conorluddy/ios-simulator-skill --skill ios-simulator-skill --area mobile --branch "Swift / Tools" --collection swift-agent-skills
npx ai-agent-skills catalog shadcn-ui/ui --skill shadcn --area frontend --branch Components

这不会创建本地副本，而是添加元数据和在活动库中的位置信息：

• 所属的货架
• 所在的分支
• 为何值得收录
• 未来应如何安装

对于已有的技能，可以使用 curate 命令进行快速编辑：

npx ai-agent-skills curate frontend-design --branch Implementation
npx ai-agent-skills curate ios-simulator-skill --collection swift-agent-skills
npx ai-agent-skills curate ios-simulator-skill --remove-from-collection swift-agent-skills
npx ai-agent-skills curate frontend-design --why "A stronger note that matches how I actually use it."
npx ai-agent-skills curate review

当我需要本地副本时，我会使用 vendor 命令：

npx ai-agent-skills vendor <repo-or-path> --skill <name> --area <shelf> --branch <branch> --why "Why this deserves a local copy."
npx ai-agent-skills vendor <repo-or-path> --skill <name> --area mobile --branch "Swift / Tools" --collection swift-agent-skills --why "Why this deserves a place in the Swift pack."

源代码仓库

当前的上游来源构成：

源代码仓库	技能数量
anthropics/skills	11
MoizIbnYousaf/Ai-Agent-Skills	11
openai/skills	9
Dimillian/Skills	4
wshobson/agents	4
rgmez/apple-accessibility-skills	3
ComposioHQ/awesome-claude-skills	2
andrewgleave/skills	1
arjitj2/swiftui-design-principles	1
AvdLee/Core-Data-Agent-Skill	1
AvdLee/Swift-Concurrency-Agent-Skill	1
AvdLee/Swift-Testing-Agent-Skill	1
bocato/swift-testing-agent-skill	1
conorluddy/ios-simulator-skill	1
dadederk/iOS-Accessibility-Agent-Skill	1
efremidze/swift-architecture-skill	1
emilkowalski/skill	1
Erikote04/Swift-API-Design-Guidelines-Agent-Skill	1
ivan-magda/swift-security-skill	1
PasqualeVittoriosi/swift-accessibility-skill	1
raphaelsalaja/userinterface-wiki	1
shadcn-ui/ui	1
twostraws/Swift-Concurrency-Agent-Skill	1
twostraws/Swift-Testing-Agent-Skill	1
twostraws/SwiftData-Agent-Skill	1
twostraws/SwiftUI-Agent-Skill	1
vanab/swiftdata-agent-skill	1

本库中最大的两个上游发布者是 Anthropic 和 OpenAI。我会浏览、挑选并上架，但不会完全复制他们发布的所有内容。

命令

# 浏览
npx ai-agent-skills
npx ai-agent-skills browse
npx ai-agent-skills list
npx ai-agent-skills list --work-area frontend
npx ai-agent-skills collections
npx ai-agent-skills search frontend
npx ai-agent-skills info frontend-design
npx ai-agent-skills preview pdf

# 安装
npx ai-agent-skills install <技能-名称 >
npx ai-agent-skills swift
npx ai-agent-skills install < skill-name > -p
npx ai-agent-skills install --collection swift-agent-skills -p
npx ai-agent-skills < 作者/仓库 >
npx ai-agent-skills install < 作者/仓库 >
npx ai-agent-skills install < 作者/仓库 >@< 技能-名称 >
npx ai-agent-skills install < 作者/仓库 > --skill < 名称 >
npx ai-agent-skills install < 作者/仓库 > --list
npx ai-agent-skills install ./本地路径
npx ai-agent-skills install < 技能-名称 > --dry-run

# 维护
npx ai-agent-skills sync [名称]
npx ai-agent-skills uninstall < 名称 >
npx ai-agent-skills check
npx ai-agent-skills doctor
npx ai-agent-skills validate [路径]

# 策划
npx ai-agent-skills catalog < 作者/仓库 > --list
npx ai-agent-skills catalog < 作者/仓库 > --skill < 名称 > --area < 架子 > --branch < 分支 > --why "< 编辑说明 >"
npx ai-agent-skills curate < 技能-名称 > --branch "< 分支 >"
npx ai-agent-skills curate review
npx ai-agent-skills vendor < 仓库或路径 > --skill < 名称 > --area < 架子 > --branch < 分支 > --why "< 编辑说明 >"

测试

• npm test 快速回归覆盖 CLI 行为、模式规则、路由和本地安装流程。
• npm run test:live 不使用模拟的真实验证。克隆真实的上游仓库，捕获原始的 SKILL.md 前置元数据和文件清单，在隔离的临时目录和项目中运行真实的安装/同步/卸载流程，通过真实的 PTY 驱动 TUI，并将报告写入 tmp/live-test-report.json。
• npm run test:live:quick 更小规模的实时测试矩阵，用于在相同的无模拟流水线下更快地迭代。

旧版代理支持

仍可通过 --agent < 名称 > 支持：

• claude
• cursor
• codex
• amp
• vscode
• copilot
• gemini
• goose
• opencode
• letta
• kilocode
• project

我关注的点

• 小型架子
• 清晰的来源
• 解释为何保留某项内容的注释
• 上游仓库保持其上游地位
• 一个看起来被精心维护的库

贡献

这是一个精选的库。

在提交 PR 之前，请阅读 CURATION.md。

相关

• WORK_AREAS.md
• CURATION.md
• CONTRIBUTING.md
• Agent Skills 规范

Ai-Agent-Skills 快速上手指南

Ai-Agent-Skills 是一个精心策划的 AI Agent 技能库，同时提供 CLI 和 TUI 工具，帮助你构建、管理和部署属于自己的技能库。它支持将技能安装到全局或项目目录，兼容任何符合 Agent Skills 规范的 Agent（如 Claude Code 等）。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• 操作系统: macOS, Linux 或 Windows (需安装 Git Bash 或 WSL)。
• Node.js: 已安装 Node.js (推荐 v18 或更高版本)，因为该工具通过 npx 运行。
• Git: 已安装 Git，用于拉取上游技能仓库。
• Agent 环境: 已配置好支持 skills 目录的 AI Agent 环境（默认安装目标通常为 ~/.claude/skills/ 或项目下的 .agents/skills/）。

注意：本项目主要通过 npm 分发。国内开发者若遇到网络延迟，可配置 npm 镜像源加速下载：

npm config set registry https://registry.npmmirror.com

安装步骤

无需全局安装，直接使用 npx 即可运行最新版本的工具。

1. 验证运行

在终端执行以下命令打开交互式界面或查看帮助，确认工具可用：

npx ai-agent-skills

2. (可选) 初始化个人技能库

如果你想建立自己管理的技能库（而非仅使用内置库），请创建一个工作区：

npx ai-agent-skills init-library my-library
cd my-library

基本使用

场景一：直接使用内置精选库

这是最快速的用法，直接从作者维护的库中浏览并安装技能。

1. 浏览技能架 (Shelves) 查看按领域分类的技能列表（如 Frontend, Backend, Mobile 等）：

npx ai-agent-skills list

2. 安装单个技能 将指定技能安装到默认的全局目标目录：

npx ai-agent-skills install frontend-design

3. 安装到当前项目 将技能安装到当前项目的 .agents/skills/ 目录（使用 -p 标志）：

npx ai-agent-skills install pdf -p

4. 安装整套精选集合 一次性安装一个预定义的技能包（例如 Swift 开发全套）：

npx ai-agent-skills install --collection swift-agent-skills -p

5. 从上游仓库安装 直接安装来自其他开源仓库（如 anthropics/skills）的技能：

npx ai-agent-skills install anthropics/skills

---

场景二：构建和管理自己的技能库

如果你希望定制技能来源、添加备注并维护版本，请使用工作区模式。

1. 添加技能到库中 将内置技能或上游技能收录到你的库中，并指定分类（area）、分支（branch）和理由（why）：

# 添加内置技能
npx ai-agent-skills add frontend-design --area frontend --branch Implementation --why "I want this on my shelf."

# 添加上游仓库中的特定技能
npx ai-agent-skills add anthropics/skills --skill webapp-testing --area workflow --branch Testing --why "I use this when I want browser-level checks in the workspace."

2. 同步与安装 收录后，将其安装到目标位置并保持同步：

npx ai-agent-skills install frontend-design -p
npx ai-agent-skills sync frontend-design -p

3. 生成文档 更新库的说明文档，以便团队成员查阅：

npx ai-agent-skills build-docs

核心概念速查

• Shelves (技能架): 主要的组织方式，按工作领域分类（如 frontend, workflow）。
• House copies: 本地副本，包含在 npm 包中，安装快且支持离线。
• Cataloged upstream: 仅记录元数据，安装时从源仓库实时拉取，保持库轻量。
• 默认安装路径:
  • 全局：~/.claude/skills/
  • 项目：.agents/skills/