tech-leads-club/agent-skills
GitHub: tech-leads-club/agent-skills
一个安全的技能注册库，用于扩展AI编码代理能力并解决技能安全漏洞问题。
Stars: 4333 | Forks: 367
🧠 技能代理
专为专业AI编码代理打造的安全、经过验证的技能注册库
在一个超过13%的市场技能存在严重漏洞的生态系统中，
技能代理脱颖而出，作为一个经过加固的库，包含经验证、经过测试且安全的能力。
您可以满怀信心地扩展 Antigravity、Claude Code、Cursor 等更多代理。
https://tech-leads-club.github.io/agent-skills/
## 📖 目录
- [✨ 什么是技能？](#-what-are-skills)
- [🛡️ 安全与信任](#️-security--trust)
- [🤖 支持的代理](#-supported-agents)
- [🌟 精选技能](#-featured-skills)
- [🚀 快速开始](#-quick-start)
- [⚡ 工作原理](#-how-it-works)
- [🔌 MCP 服务器](#-mcp-server)
- [🤝 贡献](#-contributing)
- [🛡️ 内容与作者](#️-content--authorship)
- [📄 许可证与归属](#-license-and-attribution)
## ✨ 什么是技能？
技能是打包的指令和资源，用于扩展 AI 代理的能力。可以把它们看作是**您 AI 助手的插件**——它们教会您的代理新的工作流程、模式和专业知识。
```
packages/skills-catalog/skills/
(category-name)/
skill/
SKILL.md ← Main instructions
templates/ ← File templates
references/ ← On-demand documentation
```
## 🛡️ 安全与信任
您环境的安全是我们的首要任务。与开放市场不同，那里**13.4% 的技能存在严重问题**，`agent-skills` 是一个受管理的、加固的库：100% 开源（无二进制文件）、CI/CD 中的静态分析、通过锁文件和内容哈希实现的不可变完整性，以及人工审核的提示。CLI 采用纵深防御（清理、路径隔离、符号链接防护、原子锁文件、审计跟踪）；每个技能在发布前都经过 [Snyk Agent Scan](https://github.com/snyk/agent-scan)（前身为 mcp-scan）扫描。
→ **完整的威胁模型、实施细节和漏洞报告：**[SECURITY.md](SECURITY.md)
## 🤖 支持的代理
将技能安装到以下任何 AI 编码代理：
| 第一级（热门） | 第二级（新兴） | 第三级（企业级） |
| :-------------------------------------------------------: | :--------------------------------------------------------------------: | :-----------------------------------------------------: |
| **[Claude Code](https://claude.ai/code)** | **[Aider](https://aider.chat)** | **[Amazon Q](https://aws.amazon.com/q/developer/)** |
| **[Cline](https://github.com/cline/cline)** | **[Antigravity](https://idx.google.com)** | **[Augment](https://www.augmentcode.com)** |
| **[Cursor](https://cursor.com)** | **[Gemini CLI](https://ai.google.dev/gemini-api/docs/code-execution)** | **[Droid (Factory.ai)](https://www.factory.ai)** |
| **[GitHub Copilot](https://github.com/features/copilot)** | **[Kilo Code](https://kilocode.ai)** | **[OpenCode](https://github.com/opencode-ai/opencode)** |
| **[Windsurf](https://codeium.com/windsurf)** | **[Kiro](https://kiro.dev/)** | **[Sourcegraph Cody](https://sourcegraph.com/cody)** |
| | **[OpenAI Codex](https://openai.com/index/introducing-codex/)** | **[Tabnine](https://www.tabnine.com)** |
| | **[Roo Code](https://roo.dev)** | |
| | **[TRAE](https://docs.trae.ai)** | |
没有您喜爱的代理？请开一个 issue，我们将添加支持！
## 🌟 精选技能
一窥我们不断增长的目录中可用的内容：
| 技能 | 类别 | 描述 |
| -------------------------------------------------------------------------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **[tlc-spec-driven](
)** | 开发 | 项目与功能规划，包含四个阶段：指定 → 设计 → 任务 → 实现。创建带有验证标准的原子任务，并在会话间保持持久记忆。 |
| **[aws-advisor]()** | 云 | 专业的 AWS 云顾问，用于架构设计、安全审查和实施指导。利用 AWS MCP 工具提供基于文档的答案。 |
| **[playwright-skill]()** | 自动化 | 使用 Playwright 的完整浏览器自动化。测试页面、填写表单、截图、验证用户体验，并自动化任何浏览器任务。 |
| **[figma]()** | 设计 | 从 Figma 获取设计上下文，并将节点转换为生产代码。通过 MCP 集成实现设计到代码的转换。 |
| **[security-best-practices]()** | 安全 | 针对语言和框架的安全审查。检测漏洞，生成报告，并建议默认安全的修复方案。 |
→ 浏览所有技能
## 🚀 快速开始
### 在项目中安装技能
```
npx @tech-leads-club/agent-skills
```
这将启动一个交互式向导：
1. **选择操作** — “安装技能” 或 “更新已安装的技能”
2. **浏览与选择** — 按类别筛选或搜索
3. **选择代理** — 选择目标代理（Cursor、Claude Code 等）
4. **安装方式** — 复制（推荐）或符号链接
5. **范围** — 全局（用户主目录）或本地（仅限项目）
每一步都会显示一个 **← 返回** 选项，以便您返回并修改选择。
### CLI 选项
```
# 交互模式（默认）
npx @tech-leads-club/agent-skills
# 或：agent-skills（如全局安装）
# 列出可用技能
agent-skills list
agent-skills ls # Alias
# 安装一个技能
agent-skills install -s tlc-spec-driven
# 一次安装多个技能
agent-skills install -s aws-advisor coding-guidelines docs-writer
# 安装到特定代理
agent-skills install -s my-skill -a cursor claude-code
# 安装多个技能到多个代理
agent-skills install -s aws-advisor nx-workspace -a cursor windsurf cline
# 全局安装（至 ~/.gemini、~/.claude 等）
agent-skills install -s my-skill -g
# 使用符号链接而非复制
agent-skills install -s my-skill --symlink
# 强制重新下载（绕过缓存）
agent-skills install -s my-skill --force
# 更新特定技能
agent-skills update -s my-skill
# 更新所有已安装技能
agent-skills update
# 移除一个技能
agent-skills remove -s my-skill
# 一次移除多个技能
agent-skills remove -s skill1 skill2 skill3
agent-skills rm -s my-skill # Alias
# 从特定代理移除
agent-skills remove -s my-skill -a cursor windsurf
# 强制移除（绕过锁文件检查）
agent-skills remove -s my-skill --force
# 管理缓存
agent-skills cache --clear # Clear all cache
agent-skills cache --clear-registry # Clear only registry
agent-skills cache --path # Show cache location
# 查看审计日志
agent-skills audit # Show recent operations
agent-skills audit -n 20 # Show last 20 entries
agent-skills audit --path # Show audit log location
# 显示贡献者和致谢
agent-skills credits
# 显示帮助
agent-skills --help
```
### 全局安装（可选）
```
npm install -g @tech-leads-club/agent-skills
agent-skills # Use 'agent-skills' instead of 'npx @tech-leads-club/agent-skills'
```
## ⚡ 工作原理
CLI 根据需要从我们的 CDN 获取技能：
1. **浏览** — CLI 获取技能目录（约 45KB）
2. **选择** — 您选择需要的技能
3. **下载** — 选定的技能被下载并缓存到本地
4. **安装** — 技能被安装到您的代理配置中
### 缓存
下载的技能缓存在 `~/.cache/agent-skills/` 中，可供离线使用。
```
# 清除缓存
rm -rf ~/.cache/agent-skills
```
## 🔌 MCP 服务器
`@tech-leads-club/agent-skills-mcp` 是一个 MCP 服务器，通过**渐进式披露**将技能目录直接暴露给 AI 代理——先搜索，然后只获取所需内容。
| 工具 | 用途 |
| :------------------ | :----------------------------------- |
| `list_skills` | 按类别浏览所有技能 |
| `search_skills` | 通过意图查找技能（模糊搜索） |
| `read_skill` | 加载技能的主要指令 |
| `fetch_skill_files` | 获取特定的参考文件 |
仅当用户明确要求浏览/列出目录时，才应调用 `list_skills`。
**快速安装**（适用于任何兼容 MCP 的客户端）：
```
{
"mcpServers": {
"agent-skills": {
"command": "npx",
"args": ["-y", "@tech-leads-club/agent-skills-mcp"]
}
}
}
```
→ 所有客户端（Cursor、Claude Code、VS Code 等）的完整设置、缓存和错误参考：**[packages/mcp/README.md](packages/mcp/README.md)**
## 🛡️ 内容与作者
此仓库是一个策划的技能集合，旨在造福社区。我们深深尊重所有创作者的知识产权和意愿。
如果您是此处包含的任何内容的作者，并希望将其**移除**或**更新**，请[开一个 issue](https://github.com/tech-leads-club/agent-skills/issues/new) 或联系维护者。
## 📄 许可证与归属
- **软件引擎：** 应用程序源代码（CLI、脚本、工具）根据 **[MIT 许可证](LICENSE)** 授权。
- **Tech Leads Club 技能：** 除非另有说明，所有由仓库维护者编写的技能文件（`SKILL.md`）均根据 **[知识共享署名 4.0 国际许可证 (CC-BY-4.0)](https://creativecommons.org/licenses/by/4.0/)** 授权。
- **第三方技能：** 此目录中包含的一些技能由社区或原始作者创建。这些技能保留其原始许可证和版权。请查看各个 `SKILL.md` 文件以获取具体的许可和作者归属信息。
_如果您使用我们的技能目录，无论以何种方式使用，您**必须**注明归属给 Tech Leads Club。_
## ⭐ 星标历史
由 Tech Leads Club 社区用 ❤️ 构建
标签：AI工具扩展, AI插件系统, AI编码代理, AI编程工具, DNS解析, MITM代理, Node.js项目, npm包, Nx构建系统, TypeScript开发, 代理系统管理, 代码生成辅助, 威胁情报, 开发者工具, 开源项目, 技能注册表, 技能管理平台, 编码代理扩展, 编程辅助工具, 自动化发布, 自动化攻击, 语义化发布, 软件工程工具