openskills README

The project's README from github.com/numman-ali/openskills. As one markdown file: README.md.

OpenSkills

Universal skills loader for AI coding agents

One CLI. Every agent. Same format as Claude Code.

npm version npm downloads License

Quick Start · How It Works · Commands · Create Skills · FAQ

✨ 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

🧠 How It Works

Claude Code System Prompt (Skills)

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

<available_skills>
<skill>
<name>pdf</name>
<description>Comprehensive PDF manipulation toolkit for extracting text and tables...</description>
<location>plugin</location>
</skill>
</available_skills>

OpenSkills: Same Format, Universal Loader

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

npx openskills read <skill-name>

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

Side-by-Side

Aspect Claude Code OpenSkills
Prompt Format <available_skills> XML Same XML
Skill Storage .claude/skills/ .claude/skills/ (default)
Invocation Skill("name") tool npx openskills read <name>
Marketplace Anthropic marketplace GitHub (anthropics/skills)
Progressive Disclosure ✅ ✅
Show the exact AGENTS.md format OpenSkills writes 
<skills_system priority="1">

## Available Skills

<!-- SKILLS_TABLE_START -->
<usage>
When users ask you to perform tasks, check if any of the available skills below can help complete the task more effectively.

How to use skills:
- Invoke: `npx openskills read <skill-name>` (run in your shell)
- The skill content will load with detailed instructions
- Base directory provided in output for resolving bundled resources

Usage notes:
- Only use skills listed in <available_skills> below
- Do not invoke a skill that is already loaded in your context
</usage>

<available_skills>

<skill>
<name>pdf</name>
<description>Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms...</description>
<location>project</location>
</skill>

</available_skills>
<!-- SKILLS_TABLE_END -->

</skills_system>

🔧 Install Skills

From Anthropic Marketplace

npx openskills install anthropics/skills

From Any GitHub Repo

npx openskills install your-org/your-skills

From a Local Path

npx openskills install ./local-skills/my-skill

From Private Git Repos

npx openskills install [email protected]:your-org/private-skills.git

🌍 Universal Mode (Multi-Agent Setups)

If you use Claude Code and other agents with one AGENTS.md, install to .agent/skills/ to avoid conflicts with Claude's plugin marketplace:

npx openskills install anthropics/skills --universal

Priority order (highest wins):

  1. ./.agent/skills/
  2. ~/.agent/skills/
  3. ./.claude/skills/
  4. ~/.claude/skills/

🧰 Commands

npx openskills install <source> [options]  # Install from GitHub, local path, or private repo
npx openskills sync [-y] [-o <path>]       # Update AGENTS.md (or custom output)
npx openskills list                        # Show installed skills
npx openskills read <name>                 # Load skill (for agents)
npx openskills update [name...]            # Update installed skills (default: all)
npx openskills manage                      # Remove skills (interactive)
npx openskills remove <name>               # Remove specific skill

Flags

🧬 The SKILL.md Format

OpenSkills uses Anthropic's exact format:

---
name: pdf
description: Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms.
---

# PDF Skill Instructions

When the user asks you to work with PDFs, follow these steps:
1. Install dependencies: `pip install pypdf2`
2. Extract text using scripts/extract_text.py
3. Use references/api-docs.md for details

Skills are loaded on demand, keeping your agent's context clean and focused.

🧪 Creating Your Own Skills

Minimal Structure

my-skill/
└── SKILL.md

With Resources

my-skill/
├── SKILL.md
├── references/
├── scripts/
└── assets/

Install your own skill:

npx openskills install ./my-skill

git clone [email protected]:your-org/my-skills.git ~/dev/my-skills
mkdir -p .claude/skills
ln -s ~/dev/my-skills/my-skill .claude/skills/my-skill

Authoring Guide

npx openskills install anthropics/skills
npx openskills read skill-creator

🔄 Updating Skills

If you installed skills from a git repo, you can refresh them anytime:

npx openskills update

To update specific skills, pass a comma-separated list:

npx openskills update git-workflow,check-branch-first

If a skill was installed before updates were tracked, re-install it once to record its source.

✅ Tips

❓ FAQ

Why CLI instead of MCP?

MCP is for dynamic tools. Skills are static instructions + resources.

MCP and skills solve different problems. OpenSkills keeps skills lightweight and universal.

📋 Requirements

📜 License

Apache 2.0

Attribution

Implements Anthropic's Agent Skills specification.

Not affiliated with Anthropic. Claude, Claude Code, and Agent Skills are trademarks of Anthropic, PBC.

openskills (numman-ali/openskills)

Searching Database…

10.8K ·GitHub
Openskills
Что это такое?OpenSkills — это универсальный загрузчик для командной строки (CLI), который переносит систему Agent Skills от Anthropic (файлы SKILL.md) в любого ИИ-агента для программирования, а не только в Claude Code — включая Cursor, Windsurf, Aider и Codex.
Это CLI-инструмент или плагин, который я устанавливаю внутрь агента?Это отдельная программа на Node.js, которую запускают через npx или устанавливают глобально. Она записывает скиллы в папку и создаёт соответствующий XML-блок в вашем AGENTS.md, чтобы любой совместимый агент мог его прочитать.
Как с его помощью установить скиллы?Скиллы можно брать из маркетплейса Anthropic, из любого репозитория GitHub, из локальной папки или из приватного git-репозитория. По умолчанию они попадают в ./.claude/skills (или в ./.agent/skills с флагом --universal), а флаг --global устанавливает их в ~/.claude/skills.
Что нужно установить перед использованием?Нужен Node.js версии 20.6 или новее, а также Git, если вы хотите устанавливать скиллы из репозитория.
Нужен ли для работы установленный Claude Code?Нет. OpenSkills воспроизводит точный формат скиллов и XML-промпт Claude Code, поэтому другие агенты могут использовать те же скиллы, даже если Claude Code вообще не установлен.
Это работает только с Claude Code или и с другими агентами для программирования?Инструмент создан для работы с несколькими агентами: Claude Code, Cursor, Windsurf, Aider, Codex и любым инструментом, который читает файл AGENTS.md.
Зачем использовать CLI вместо MCP для скиллов?MCP предназначен для динамических инструментов, а скиллы — это статичные инструкции и ресурсы, которые достаточно хранить в виде файлов на диске без сервера. Поэтому OpenSkills делает их легковесными и работает с любым агентом, независимо от поддержки MCP.
Можно ли обновлять скиллы после установки?Да: если скилл пришёл из git-репозитория, его можно обновить в любой момент. При желании можно передать через запятую список названий скиллов, чтобы обновить только некоторые из них.
Что будет, если использовать Claude Code вместе с другими агентами?Используйте флаг --universal, чтобы установить скиллы в .agent/skills/ вместо .claude/skills/. Так не возникнет конфликтов с собственным маркетплейсом плагинов Claude. OpenSkills сам определяет приоритет между обоими расположениями.
Могу ли я создать и установить собственные скиллы?Да: вы пишете SKILL.md с необязательными файлами ресурсов, затем устанавливаете его из локальной папки. Для локальной разработки можно сделать симлинк и дорабатывать скилл по ходу работы.
What are similar projects?testsprite-cli, agent-skills, copperhead, open-pstack, pstack, headroom, skills, agentic-playwright
Which topics is it in?windsurf, ci, cli-tool, cursor, skills, anthropic, coding-agent, agent-skills, ai-agent, codex, command-line-tool, claude-code
Creator
numman-ali
Size
0.2 MB
Stars
10.8K
Updated
CommitJan 18Releasev1.5.0Jan 17
Age
11mo
Commits · 90 Days