numman-ali/openskills

AI编码代理通用技能加载器

一个CLI。每个代理。格式和Claude Code一样。

快速入门 ·工作原理 ·指令 ·创建技能 ·常见问题解答

---

✨ 什么是OpenSkills？

OpenSkills 将 Anthropic 的技能系统带到所有 AI 编码代理中——Claude Code、Cursor、Windsurf、Aider、Codex 以及任何能读取 AGENTS.md 的程序。

把它当作 SKILL.md 的通用安装工具。

---

🚀 快速启动

默认情况下，安装是项目本地的（./.claude/skills，或./.agent/skills与--universal）。~/.claude/skills使用--global。

---

✅ 为什么选择开放技能

• 完全兼容Claude代码 — 相同的提示格式、相同的市场、相同的文件夹结构
• Universal — 与Claude Code、Cursor、Windsurf、Aider、Codex等合作
• 渐进披露 — 仅在必要时加载技能（保持上下文简洁）
• 对仓库友好 — 技能存在于你的项目中，并且可以进行版本化
• 私有友好 — 从本地路径或私有git仓库安装

---

🧠 工作原理

克劳德代码系统提示（技能）

Claude Code 将技能以 ** 文件形式发送 *SKILL.md 文件，并暴露在 块内。

---

✨ What Is OpenSkills?

OpenSkills brings Anthropic’s skills system to every AI coding agent — Claude Code, Cursor, Windsurf, Aider, Codex, and anything that can read AGENTS.md.

Think of it as the universal installer for SKILL.md.

---

🚀 Quick Start

npx openskills install anthropics/skills
npx openskills sync

By default, installs are project-local (./.claude/skills, or ./.agent/skills with --universal). Use --global for ~/.claude/skills.

---

✅ Why OpenSkills

• Exact Claude Code compatibility — same prompt format, same marketplace, same folder structure
• Universal — works with Claude Code, Cursor, Windsurf, Aider, Codex, and more
• Progressive disclosure — load skills only when needed (keeps context clean)
• Repo-friendly — skills live in your project and can be versioned
• Private friendly — install from local paths or private git repos

---

🧠 How It Works

Claude Code System Prompt (Skills)

Claude Code ships skills as SKILL.md files and exposes them inside a `` block. When the user asks for a task, Claude dynamically loads the matching skill.

pdf
Comprehensive PDF manipulation toolkit for extracting text and tables...
plugin

OpenSkills: Same Format, Universal Loader

OpenSkills generates the exact same `` XML in your AGENTS.md and loads skills via:

npx openskills read 

So any agent that can read AGENTS.md can use Claude Code skills without needing Claude Code itself.

Side-by-Side

## Available Skills