内容
<h1 align="center">AI 智能体技能</h1>
<p align="center">
<strong>我整理的智能体技能库,以及用于构建您自己的技能库的软件包。</strong>
</p>
<p align="center">
我实际保留的技能,按照我的工作方式组织。
</p>
<!-- GENERATED:library-stats:start -->
<p align="center">
<a href="https://github.com/MoizIbnYousaf/Ai-Agent-Skills"><img alt="GitHub stars" src="https://img.shields.io/github/stars/MoizIbnYousaf/Ai-Agent-Skills?style=for-the-badge&label=stars&labelColor=313244&color=89b4fa&logo=github&logoColor=cdd6f4" /></a>
<a href="https://www.npmjs.com/package/ai-agent-skills"><img alt="npm version" src="https://img.shields.io/npm/v/ai-agent-skills?style=for-the-badge&label=version&labelColor=313244&color=b4befe&logo=npm&logoColor=cdd6f4" /></a>
<a href="https://www.npmjs.com/package/ai-agent-skills"><img alt="npm total downloads" src="https://img.shields.io/npm/dt/ai-agent-skills?style=for-the-badge&label=downloads&labelColor=313244&color=f5e0dc&logo=npm&logoColor=cdd6f4" /></a>
<a href="https://github.com/MoizIbnYousaf/Ai-Agent-Skills#shelves"><img alt="Library structure" src="https://img.shields.io/badge/library-120%20skills%20%C2%B7%206%20shelves-cba6f7?style=for-the-badge&labelColor=313244&logo=bookstack&logoColor=cdd6f4" /></a>
</p>
<p align="center"><sub>17 个本地副本 · 103 个已编目上游</sub></p>
<!-- GENERATED:library-stats:end -->
<p align="center"><em>精心挑选、分类和维护。</em></p>
<p align="center">
<a href="./docs/workflows/start-a-library.md"><strong>构建您自己的技能库</strong></a>
·
<a href="./FOR_YOUR_AGENT.md"><strong>适用于您的智能体</strong></a>
</p>
## 技能库
`ai-agent-skills` 提供了两项功能:
它包含了我整理的技能库,以及用于构建和管理您自己的技能库的 CLI 和 TUI。
它适用于任何与 Agent Skills 兼容的智能体。
捆绑的技能库按照我的工作方式组织:
- 从 `frontend` 或 `workflow` 等货架开始
- 保持集合足够小,以便快速浏览
- 保持来源可见
- 保留解释技能为何在此的注释
使用 `skills.sh` 来浏览整个生态系统。
使用 `ai-agent-skills` 时,您需要一个具有货架、来源和注释的小型技能库。
## 新增功能(4.3.1)
- 营销软件包同步到 `marketing-cli@0.5.4` — 共 53 个技能,包括最新的 `cmo-remotion` 和 `remotion-best-practices` 镜像
- 将上游营销软件包源从 `MoizIbnYousaf/mktg` 重命名为 `MoizIbnYousaf/marketing-cli`,涉及编目元数据、安装源和源 URL
- 捆绑技能库现在包含 115 个编目技能(17 个本地副本,98 个编目上游)
- 与 `4.3.0` 版本相同的私有技能库引导、批量导入和管理工作区流程
## 当前状态
我于 2025 年 12 月 17 日启动了这个项目,当时 `skills.sh` 还不存在,生态系统也没有明确的默认通用安装程序。
最初,这个仓库就是安装程序。它仍然是安装程序。
起初只是一个安装程序,现在是一个构建和管理您自己的技能库的地方。
## 工作原理
这里的每个技能要么是本地副本,要么是从上游编目选取的。
- `本地副本`
`skills/<name>/` 下的本地文件夹。
这些安装快速,离线工作,并随 npm 软件包一起提供。
- `编目上游`
`skills.json` 中的元数据,没有本地文件夹。
这些保留在上游,当您需要时从源仓库安装。
上游工作保留在上游。这使得技能库保持精简。
## 适用于您的智能体
告诉您的智能体为您构建技能库。粘贴此内容,或直接指向此仓库 — 协议中包含所有必要的内容。
完整的协议和策划者决策框架:[FOR_YOUR_AGENT.md](./FOR_YOUR_AGENT.md)
### 将此内容粘贴到您的智能体中
```text
使用 `ai-agent-skills` 为我建立一个托管的团队技能库。
在开始之前,请阅读上面的完整策划者决策协议:https://raw.githubusercontent.com/MoizIbnYousaf/Ai-Agent-Skills/main/FOR_YOUR_AGENT.md
使用 `npx` 搭配 CLI。请勿手动编辑 `skills.json`、`README.md` 或 `WORK_AREAS.md`,如果命令已经存在。
1. 获取并阅读上方的 FOR_YOUR_AGENT.md — 它包含完整的策划者决策协议。
2. 使用 `npx ai-agent-skills init-library <name>` 创建一个工作区。
3. 最多向我提出 3 个简短问题:您的工作类型、规模、本地草稿或共享仓库。
4. 将我的技术栈映射到货架:前端、后端、移动端、工作流、智能体工程。
5. 运行发现循环:`list --area <shelf>`、`search <query>`、`collections`。
6. 添加 3-8 个技能,并为每次修改明确指定 `--area`、`--branch` 和 `--why`。
7. 在完成前运行 `npx ai-agent-skills build-docs`。
8. 如果我希望共享:`git init && git add . && git commit -m "Initialize skills library" && gh repo create`。
9. 告诉我您添加了什么、哪些货架以及团队成员的安装命令。
```
与库一起安装的配套工作流技能(在您使用库时自动安装):
```text
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
```
## 快速入门
### 使用捆绑的技能库
```bash
# 打开终端浏览器
npx ai-agent-skills
# 列出货架
npx ai-agent-skills list
# 从库中安装技能
npx ai-agent-skills install frontend-design
# 将 Swift hub 安装到默认全局目标
npx ai-agent-skills swift
# 安装整个策划的软件包
npx ai-agent-skills install --collection swift-agent-skills -p
# 安装 mktg 营销软件包
npx ai-agent-skills mktg
npx ai-agent-skills marketing-cli
# 安装到项目货架
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>` 支持。
### 启动您自己的技能库
```bash
# 创建托管工作区
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 sync 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 build-docs
# 或在原位引导现有的扁平技能仓库
cd ~/projects/my-skills
npx ai-agent-skills init-library . --areas "mobile,workflow,agent-engineering" --import --auto-classify
npx ai-agent-skills browse
# 无效的私有名称将被跳过并报告。
# 低置信度的导入会回退到工作流,并带有 needs-curation 标签。
```
## 工作区模式
工作区模式现在是正常流程的一部分。
首先使用托管的工作区,添加一些技能,然后使用 `add`、`catalog`、`vendor`、`sync` 和 `build-docs` 保持您的货架更新。
```bash
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 import --auto-classify
# 审查备用桶并修复货架位置
npx ai-agent-skills list --area workflow
npx ai-agent-skills curate some-skill --area mobile --branch "Mobile / Testing" --why "Why it belongs."
```
工作流程指南:
- [启动技能库](./docs/workflows/start-a-library.md)
- [添加上游技能](./docs/workflows/add-an-upstream-skill.md)
- [创建本地副本](./docs/workflows/make-a-house-copy.md)
- [组织货架](./docs/workflows/organize-shelves.md)
- [刷新已安装的技能](./docs/workflows/refresh-installed-skills.md)
## 浏览
大多数浏览从两个地方开始:
| 视图 | 存在原因 | 从这里开始 |
| --- | --- | --- |
| 货架 | 了解库的主要方式:从工作类型开始,然后深入到该货架上的精选技能。 | `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` 用于策划者清理队列
## 货架
货架是主要的结构。
<!-- GENERATED:shelf-table:start -->
| 货架 | 技能 | 涵盖内容 |
| --- | --- | --- |
| 前端 | 10 | 界面、设计系统、浏览器工作和产品润色。 |
| 后端 | 5 | 系统、数据、安全性和运行时操作。 |
| 移动端 | 24 | Swift、SwiftUI、iOS 和 Apple 平台开发,并为未来的 React Native 分支留出空间。 |
| 工作流 | 11 | 文件、文档、规划、发布工作和研究到输出的流程。 |
| 智能体工程 | 14 | MCP、技能构建、提示学科和 LLM 应用工作。 |
| 营销 | 56 | 品牌、策略、文案、分发、创意、SEO、转化和增长工作。 |
<!-- GENERATED:shelf-table:end -->
完整的映射位于 [WORK_AREAS.md](./WORK_AREAS.md)。
## 集合
集合是较小的集合。有用,但次于货架。
<!-- GENERATED:collection-table:start -->
| 集合 | 存在原因 | 从这里开始 |
| --- | --- | --- |
| `my-picks` | 一个简短的初始堆栈。这些是我首先使用的技能。 | `frontend-design`、`mcp-builder`、`pdf` |
| `build-apps` | 用于交付精致应用的前端、UI 和设计工作。 | `frontend-design`、`figma-implement-design`、`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` | 质量保证、调试、CI 清理和可观察性。 | `playwright`、`webapp-testing`、`gh-fix-ci` |
| `docs-and-research` | 文档、文件、研究和写作工作。 | `pdf`、`doc-coauthoring`、`docx` |
| `mktg` | 完整的上游 marketing-cli 剧本。安装整个集合或从中选择。 | `cmo`、`brand-voice`、`positioning-angles` |
<!-- GENERATED:collection-table:end -->
## 编目编目
当您想添加上游技能而不将其纳入时,请使用 `catalog`。
在托管的工作区中,首先使用 `add`。
使用 `catalog` 和 `vendor` 以获得更多控制。
```bash
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` 进行快速编辑:
```bash
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`:
```bash
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."
```
## 来源仓库
当前上游混合:
<!-- GENERATED:source-table:start -->
| 来源仓库 | 技能 |
| --- | --- |
| `MoizIbnYousaf/marketing-cli` | 56 |
| `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 |
<!-- GENERATED:source-table:end -->
本库中两个最大的上游发布者是 Anthropic 和 OpenAI。
我浏览、选择并分类。我不会镜像他们发布的所有内容。
## 命令
```bash
# 浏览
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 mktg
npx ai-agent-skills marketing-cli
npx ai-agent-skills install <技能名称> -p
npx ai-agent-skills install --collection swift-agent-skills -p
npx ai-agent-skills install --collection mktg -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 "<编辑备注>"
npx ai-agent-skills import [路径] --auto-classify
```
## 测试
- `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`
## 我关心的
- 小型货架
- 清晰的来源
- 解释为什么某项内容保留的注释
- 上游仓库保持在上游
- 一个看起来被照顾的库
## 贡献
这是一个精选的库。
在打开拉取请求之前,请阅读 [CURATION.md](./CURATION.md)。
## 相关
- [WORK_AREAS.md](./WORK_AREAS.md)
- [CURATION.md](./CURATION.md)
- [CONTRIBUTING.md](./CONTRIBUTING.md)
- [Agent Skills 规范](https://agentskills.io)
连接信息
猜你喜欢
暂无推荐服务器