ai-agent-skills

一条命令，把技能装进 12+ AI 编程代理

ai-agent-skills 是一个面向 AI 编程代理的通用技能安装器与包管理器。它解决的问题是：不同 AI 编码工具（Claude Code、Cursor、Codex 等）各自有独立的技能/插件格式和安装方式，开发者需要在多个运行时之间重复配置，难以复用和分发。该项目通过一条 npx 命令，把技能包统一安装到 12 种以上运行时中，让同一套技能在不同代理之间共享。核心能力包括：统一 CLI 安装与卸载、跨运行时适配、技能包版本管理、以及通过 MCP 等机制与代理集成。它适合希望把常用提示词、工具链、工作流封装成可复用技能，并在多个 AI 编程环境间无缝迁移的开发者，降低重复配置成本。

开源 free 开发框架

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1142

维护状态维护中

是否开源是

定价模式 free

项目数据

分类开发框架

开发团队MoizIbnYousaf

所属国家

官网地址

GitHubhttps://github.com/MoizIbnYousaf/ai-agent-skills

定价模式free

价格说明开源免费，通过npx安装使用

访问状态

是否开源是

开源协议MIT

主要语言JavaScript

技术栈/模型agent-skills,ai-agents,claude-code,cli,codex,cursor,developer-tools,mcp,productivity

GitHub 星标★ 1142

30天Star增速

HF 下载量

上线时间2025-12-17 00:00:00

最近更新2026-09-15 00:00:00

维护状态维护中

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-12

浏览次数0

使用教程

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

环境要求

本机已安装 Node.js 与 npm，保证 npx 命令可用（安装全部通过 npx 执行）
能访问 npm registry 与 GitHub，以便拉取技能包和上游仓库技能
已知目标 AI 编码工具的技能目录（默认全局 ~/.claude/skills/，项目 .agents/skills/）

安装与启动步骤

1浏览仓库技能清单

先用 --list 列出上游仓库里有哪些技能，确认名称后再执行安装，避免装错或重复。
```
npx ai-agent-skills install openai/skills --list
```
2安装单个技能

按技能名安装，不加 -p 时默认装到全局目标 ~/.claude/skills/，所有代理可共用。
```
npx ai-agent-skills install frontend-design
```
3安装到项目目录

加 -p 参数安装到当前项目的 .agents/skills/ 下，适合随代码仓库一起提交和分发。
```
npx ai-agent-skills install pdf -p
```
4安装整套技能包

用 --collection 一次安装整套精选技能；示例为 swift-agent-skills 包，并按项目方式安装。
```
npx ai-agent-skills install --collection swift-agent-skills -p
```
5从上游仓库安装

直接传入 owner/repo，把该仓库的技能装到默认全局目标，无需先克隆仓库。
```
npx ai-agent-skills anthropics/skills
```
6先试跑不写入

加 --dry-run 只预览将要安装的内容，不实际写入目标目录，确认无误后再去掉该参数。
```
npx ai-agent-skills install frontend-design --dry-run
```
7从本地路径安装

把本地已有的技能目录直接装入目标位置，适合调试自建技能包后再发布。
```
npx ai-agent-skills install ./local-path
```

如何确认成功

安装后检查 ~/.claude/skills/（全局）或项目内 .agents/skills/（带 -p）下是否出现对应技能目录与文件。

常见问题

Q：npx 提示找不到命令或执行失败怎么办？

A：本项目通过 npx 运行，需先安装 Node.js 与 npm，并保证网络能访问 npm registry，然后再重试命令。

Q：全局安装和项目安装有什么区别？

A：不加 -p 装到全局 ~/.claude/skills/，所有项目共用；加 -p 装到项目 .agents/skills/，只对当前项目生效。

Q：只想装上游仓库里的某一个技能怎么办？

A：可先执行 install --list 查看清单，再用 install --skill 或 @ 指定单个技能。

Q：老版本工具识别不到默认目录怎么办？

A：默认目标之外，README 说明旧的按代理划分的目标仍可通过 --agent 指定，用该参数选择对应运行时。

注意事项

默认安装目标：全局为 ~/.claude/skills/，项目为 .agents/skills/，安装前先确认想装到哪一处。
批量安装前建议先用 --list 或 --dry-run 预览，避免把不需要的技能写入目标目录。
同一套技能可安装到多个运行时目录，项目内安装（-p）更便于随仓库共享和版本管理。

核心亮点

一条 npx 命令即可跨 12+ 运行时安装技能，省去逐个工具手动配置
统一技能包管理，便于团队内复用和分发同一套代理能力
覆盖 Claude Code、Cursor、Codex 等主流 AI 编码工具，适配面广

不足之处

项目仍处成长阶段，生态与技能包数量有限
跨运行时适配依赖各工具接口，版本更新后可能存在兼容滞后

适用场景

团队统一为多名成员使用的不同 AI 编码工具批量安装同一套技能
个人开发者在 Claude Code、Cursor 等工具间切换时复用已配置技能
把内部提示词与工作流封装成技能包，通过 CLI 分发给同事

替代项目

claude-code-templates、awesome-claude-code

项目介绍

ai-agent-skills 是一个开发框架领域的开源项目，官方简介：Universal skill installer and package manager for AI coding agents. One command, 12+ runtimes. npx ai-agent-skills。项目使用 JavaScript 开发，在 GitHub 上获得 1140 星标。

上一篇：agents

下一篇：spring-ai-agent-utils