🧠 代理技能

面向专业AI编码代理的安全、经过验证的技能注册表

在一个生态系统中，超过13%的市场技能包含严重漏洞, Agent Skills 作为一个强化的库脱颖而出，其中包含已验证、经过测试且安全的功能。您可以满怀信心地扩展Antigravity、Claude Code、Cursor等工具。

https://tech-leads-club.github.io/agent-skills/

📖 目录

• ✨ 什么是技能？
• 🛡️ 安全与信任
• 🤖 支持的代理
• 🌟 精选技能
• 🚀 快速入门
• ⚡ 工作原理
• 🔌 MCP服务器
• 🤝 贡献
• 🛡️ 内容与作者身份
• 📄 许可证与署名

✨ 什么是技能？

技能是封装好的指令和资源，用于扩展AI代理的能力。可以将其视为您AI助手的插件——它们教会您的代理新的工作流程、模式和专业知识。

packages/skills-catalog/skills/
  (类别名称)/
    技能/
      SKILL.md          ← 主要说明
      templates/        ← 文件模板
      references/       ← 按需文档

🛡️ 安全与信任

您环境的安全是我们首要考虑的因素。与开放市场上13.4%的技能含有严重问题不同，agent-skills是一个受管理的、强化的库：100%开源（无二进制文件），在CI/CD中进行静态分析，通过锁定文件和内容哈希实现不可变的完整性，并由人工精选提示。CLI采用纵深防御策略（净化、路径隔离、符号链接保护、原子锁定文件、审计轨迹）；每个技能在发布前都会使用Snyk Agent Scan（原mcp-scan）进行扫描。

→ 完整的威胁模型、实施细节及漏洞报告： SECURITY.md

🤖 支持的代理

将技能安装到以下任何AI编码代理中：

_{没有找到您最喜欢的代理？提交一个问题,我们会添加支持！}

🌟 精选技能

以下是我们不断扩充的技能目录中的一些亮点：

技能	类别	描述
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。

# 交互模式（默认）
npx @tech-leads-club/agent-skills
# 或：agent-skills（若已全局安装）

# 列出可用技能
agent-skills list
agent-skills ls        # 别名

# 安装单个技能
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    # 别名

# 从特定代理移除
agent-skills remove -s my-skill -a cursor windsurf

# 强制移除（绕过锁文件检查）
agent-skills remove -s my-skill --force

# 管理缓存
agent-skills cache --clear           # 清除所有缓存
agent-skills cache --clear-registry  # 仅清除注册表缓存
agent-skills cache --path            # 显示缓存位置

# 查看审计日志
agent-skills audit                   # 显示最近的操作
agent-skills audit -n 20             # 显示最近 20 条记录
agent-skills audit --path            # 显示审计日志位置

# 显示贡献者及致谢
agent-skills credits

# 显示帮助
agent-skills --help

全局安装（可选）

npm install -g @tech-leads-club/agent-skills
agent-skills  # 使用 'agent-skills' 代替 '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

🤝 贡献

我们欢迎各位的贡献！请参阅我们的 CONTRIBUTING.md 文件，了解如何搭建本地开发环境、创建新技能、参与市场建设，以及遵循我们的发布流程等详细指南。

🛡️ 内容与作者权

本仓库是一个精选技能的集合，旨在造福社区。我们深切尊重所有创作者的知识产权及意愿。

如果您是此处包含内容的作者，并希望将其 移除 或 更新，请 提交问题 或联系维护人员。

📄 许可与署名

• 软件引擎：应用程序源代码（CLI、脚本、工具）采用 MIT 许可证 许可。
• Tech Leads Club 技能：除非另有说明，由仓库维护者编写的全部技能文件（SKILL.md）均采用 知识共享署名 4.0 国际许可协议 (CC-BY-4.0) 许可。
• 第三方技能：本目录中包含的部分技能由社区或原作者创建。这些技能保留其原始许可和版权。请查看各个 SKILL.md 文件，以了解具体的许可和作者署名信息。

如果您使用我们的技能目录，无论以何种方式使用，都必须注明 Tech Leads Club 的出处。

⭐ 星标历史

---

_{由 Tech Leads Club 社区用心打造}

Agent Skills 快速上手指南

Agent Skills 是一个安全、经过验证的技能注册表，专为专业 AI 编程助手（如 Cursor、Claude Code、Cline 等）设计。它提供了经过严格测试和静态分析的技能包，帮助你的 AI 代理掌握新的工作流、模式和专业知识，同时规避了开源市场中常见的安全风险。

环境准备

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

• Node.js: 版本需 >= 22。
• 包管理器: npm、yarn 或 pnpm（推荐使用最新稳定版）。
• 目标 AI 代理: 已安装并配置好任意支持的 AI 编程工具（如 Cursor, Claude Code, Windsurf, Cline 等）。

注意：本项目完全基于 TypeScript 构建，无需额外安装 TypeScript 编译器即可使用 CLI 工具。

安装步骤

你可以选择临时运行或全局安装两种方式。

方式一：临时运行（推荐尝试）

无需安装，直接使用 npx 运行交互式向导：

npx @tech-leads-club/agent-skills

方式二：全局安装（常用）

如果你需要频繁使用，建议全局安装以便直接调用命令：

npm install -g @tech-leads-club/agent-skills

安装完成后，即可在任何目录下直接使用 agent-skills 命令。

国内加速提示：如果下载速度较慢，可配置淘宝镜像源：

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

基本使用

1. 交互式安装技能（最简单）

运行以下命令启动交互式向导，它将引导你完成技能浏览、选择和安装全过程：

agent-skills
# 或者未全局安装时：npx @tech-leads-club/agent-skills

操作流程：

1. 选择操作：选择 "Install skills"（安装技能）。
2. 浏览与筛选：按类别浏览或搜索所需技能（如 aws-advisor, playwright-skill 等）。
3. 选择目标代理：勾选你要应用技能的 AI 代理（例如 Cursor, Claude Code）。
4. 选择安装方式：推荐选择 Copy（复制），也可选 Symlink（符号链接）。
5. 选择范围：选择 Global（全局用户目录）或 Local（仅当前项目）。

2. 命令行快速安装

如果你明确知道需要的技能名称，可以直接通过命令安装。

安装单个技能到默认代理：

agent-skills install -s tlc-spec-driven

安装多个技能到指定代理（例如 Cursor 和 Windsurf）：

agent-skills install -s aws-advisor playwright-skill -a cursor windsurf

全局安装技能（应用到所有支持的用户级配置）：

agent-skills install -s security-best-practices -g

3. 常用管理命令

• 查看可用技能列表：

  agent-skills list
  

• 更新已安装的技能：

  agent-skills update
  

• 移除技能：

  agent-skills remove -s skill-name
  

• 查看操作审计日志：

  agent-skills audit
  

安装完成后，重启你的 AI 编程助手（如 Cursor 或 Claude Code），即可在对话中调用新安装的技能功能。