agent-skills

给 AI 编码代理装上工程规范，产出直接可交付

开源 unknown 开发框架

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 104409

维护状态活跃

是否开源是

定价模式 unknown

项目预览

项目数据

分类开发框架

开发团队addyosmani

所属国家

官网地址https://skills.addy.ie

GitHubhttps://github.com/addyosmani/agent-skills

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言JavaScript

技术栈/模型agent-skills,antigravity,claude-code,codex,cursor,skills

GitHub 星标★ 104409

30天Star增速

HF 下载量

上线时间2026-02-15 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-11

浏览次数0

项目介绍

agent-skills 是一套面向 AI 编程代理的生产级工程技能集合，主要解决 AI 编码助手在真实项目中「会写代码但不懂工程规范」的问题。它把代码审查、测试编写、重构、调试、依赖管理、提交规范等工程实践封装成可被代理调用的技能模块，让 Claude Code、Codex、Cursor、Antigravity 等工具在完成任务时遵循统一的工程标准，而不是随意生成代码。项目以 JavaScript 实现，核心能力包括技能定义与注册、按任务场景自动匹配技能、与多种主流 AI 编码代理集成，以及可扩展的自定义技能机制。开发者可以把它当作 AI 代理的「工程规范层」，在已有代理之上补齐流程化、可复用的专业能力，减少人工反复纠正和返工，让 AI 产出的代码更接近团队实际交付标准。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

Node.js 环境（使用 npx 执行 skills CLI）
已安装至少一个支持的 AI 编码代理（Claude Code、Cursor、Codex、Gemini CLI、Copilot 等）
使用插件/克隆安装方式时需要 Git 与仓库访问权限

安装与启动步骤

1浏览技能列表

安装前先查看仓库里全部 25 个技能，确认需要哪些，避免装进不需要的规范。
```
npx skills add addyosmani/agent-skills --list
```
2安装全部技能

通过开源 skills CLI 一次性安装全部技能，支持 70 多种代理，是文档推荐的最快路径。
```
npx skills add addyosmani/agent-skills
```
3安装单个技能

只装某个技能时，只会复制 skills// 目录，仓库级 references/ 共享清单不可用。
```
npx skills add addyosmani/agent-skills --skill code-review-and-quality
```
4Claude 插件安装

在 Claude Code 内先添加插件市场再安装插件；若报 SSH 权限错误改用下方 HTTPS 方式。
```
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
```
5本地克隆调试

适合本地开发或想直接使用整仓内容时，克隆后用 --plugin-dir 指向本地目录加载。
```
git clone https://github.com/addyosmani/agent-skills.git
claude --plugin-dir /path/to/agent-skills
```
6Codex 插件安装

需 Codex CLI v0.122+：第一条命令注册市场，第二条安装插件，装好后用 @ 调用技能。
```
codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills
```
7Gemini CLI 安装

作为原生技能安装以支持自动发现，也可把内容写进 GEMINI.md 作为持久上下文。
```
gemini skills install https://github.com/addyosmani/agent-skills.git --path skills
```

关键配置

配置项	必填	说明	示例
`.cursor/skills/`	否	Cursor 的工作流技能目录，需从 agent-skills/skills/ 同步过来	`.cursor/skills/`
`.cursor/rules/*.mdc`	否	Cursor 中存放简短策略，不要把完整技能粘贴进规则	`.cursor/rules/policy.mdc`
`AGENTS.md`	否	OpenCode 项目级说明文件，配合内置 skill 工具使用	`AGENTS.md`
`GEMINI.md`	否	Gemini CLI 的持久上下文文件，可写入技能内容	`GEMINI.md`
`.github/copilot-instructions.md`	否	GitHub Copilot 使用的技能内容指令文件	`.github/copilot-instructions.md`
`.opencode/skills/`	否	OpenCode 技能目录，也可放在用户级配置目录下	`~/.config/opencode/skills/`

如何确认成功

安装后代理的斜杠菜单出现 /spec-driven-development 等技能名，或在对话中用 @ 成功调用技能即安装成功。

常见问题

Q：只安装一个技能会有什么缺失？

A：单技能 npx 安装只复制 skills//，不含仓库级 references/ 目录，补充清单路径不可用；可改用整仓安装、克隆仓库，或把所需清单复制到已装技能的 references/ 目录。

Q：Claude Code 添加市场时报 SSH 错误怎么办？

A：市场通过 SSH 克隆仓库。可在 GitHub 配置 SSH 密钥，或改用完整 HTTPS URL 添加；Windows/macOS 上还可执行 git config --global url."https://github.com/".insteadOf git@github.com: 强制走 HTTPS。

Q：Copilot 里为什么没有 /spec 等命令？

A：这些生命周期斜杠命令是 Claude Code 专属，不会出现在 Copilot 中，需改为按技能名调用，例如 /spec-driven-development。

Q：不在支持列表里的代理能用吗？

A：可以。技能本质是纯 Markdown 文件，任何接受系统提示或指令文件的代理都能使用，具体见文档中的其他宿主说明。

注意事项

项目本身无需启动服务，安装的是可在代理中调用的技能（Markdown）内容。
技能覆盖定义、规划、构建、验证、评审、发布全生命周期，配合 /spec、/plan、/build、/test、/review、/ship 使用。
不同代理的安装方式不同，README 未覆盖的代理请参考仓库 docs 目录中的对应说明。

核心亮点

把代码审查、测试、重构等工程实践模块化为可复用技能，代理可直接调用
兼容 Claude Code、Codex、Cursor、Antigravity 等多种主流 AI 编码工具
技能可自定义扩展，团队能沉淀自己的工程规范并统一执行

不足之处

技能效果依赖底层代理能力，不同工具间表现可能不一致
技能数量增多后如何选择与组合，缺少明确的最佳实践指引

适用场景

让 AI 代理按团队规范自动完成代码审查与提交
在 Cursor 或 Claude Code 中执行标准化重构和测试补全
为自研 AI 编码助手快速接入一套现成的工程技能库

替代项目

SuperClaude、claude-code-templates

上一篇：flutter_edge_ai

下一篇：agents