[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-73472":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":15,"forks30d":15,"starsTrendScore":19,"compositeScore":20,"rankGlobal":9,"rankLanguage":9,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":24,"hasPages":22,"topics":25,"createdAt":9,"pushedAt":9,"updatedAt":26,"readmeContent":27,"aiSummary":28,"trendingCount":15,"starSnapshotCount":15,"syncStatus":29,"lastSyncTime":30,"discoverSource":31},73472,"openskills","numman-ali\u002Fopenskills","numman-ali","Universal skills loader for AI coding agents - npm i -g openskills",null,"TypeScript",10370,662,58,28,0,31,62,265,93,118.46,"Other",false,"main",true,[],"2026-06-12 04:01:09","\u003Cdiv align=\"center\">\n\n\u003Cimg src=\".\u002Fassets\u002Flogo.svg\" alt=\"OpenSkills\" width=\"420\" \u002F>\n\n\u003Cbr\u002F>\n\u003Cbr\u002F>\n\n**Universal skills loader for AI coding agents**\n\nOne CLI. Every agent. Same format as Claude Code.\n\n[![npm version](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fopenskills.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fopenskills)\n[![npm downloads](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002Fopenskills.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fopenskills)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-Apache%202.0-blue.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FApache-2.0)\n\n[Quick Start](#-quick-start) · [How It Works](#-how-it-works) · [Commands](#-commands) · [Create Skills](#-creating-your-own-skills) · [FAQ](#-faq)\n\n\u003C\u002Fdiv>\n\n---\n\n## ✨ What Is OpenSkills?\n\nOpenSkills brings **Anthropic's skills system** to every AI coding agent — Claude Code, Cursor, Windsurf, Aider, Codex, and anything that can read `AGENTS.md`.\n\n**Think of it as the universal installer for SKILL.md.**\n\n---\n\n## 🚀 Quick Start\n\n```bash\nnpx openskills install anthropics\u002Fskills\nnpx openskills sync\n```\n\nBy default, installs are project-local (`.\u002F.claude\u002Fskills`, or `.\u002F.agent\u002Fskills` with `--universal`). Use `--global` for `~\u002F.claude\u002Fskills`.\n\n---\n\n## ✅ Why OpenSkills\n\n- **Exact Claude Code compatibility** — same prompt format, same marketplace, same folder structure\n- **Universal** — works with Claude Code, Cursor, Windsurf, Aider, Codex, and more\n- **Progressive disclosure** — load skills only when needed (keeps context clean)\n- **Repo-friendly** — skills live in your project and can be versioned\n- **Private friendly** — install from local paths or private git repos\n\n---\n\n## 🧠 How It Works\n\n### Claude Code System Prompt (Skills)\n\nClaude Code ships skills as **SKILL.md files** and exposes them inside a `\u003Cavailable_skills>` block. When the user asks for a task, Claude dynamically loads the matching skill.\n\n```xml\n\u003Cavailable_skills>\n\u003Cskill>\n\u003Cname>pdf\u003C\u002Fname>\n\u003Cdescription>Comprehensive PDF manipulation toolkit for extracting text and tables...\u003C\u002Fdescription>\n\u003Clocation>plugin\u003C\u002Flocation>\n\u003C\u002Fskill>\n\u003C\u002Favailable_skills>\n```\n\n### OpenSkills: Same Format, Universal Loader\n\nOpenSkills generates the **exact same `\u003Cavailable_skills>` XML** in your `AGENTS.md` and loads skills via:\n\n```bash\nnpx openskills read \u003Cskill-name>\n```\n\nSo any agent that can read `AGENTS.md` can use Claude Code skills without needing Claude Code itself.\n\n### Side-by-Side\n\n| Aspect | Claude Code | OpenSkills |\n|--------|-------------|------------|\n| **Prompt Format** | `\u003Cavailable_skills>` XML | Same XML | \n| **Skill Storage** | `.claude\u002Fskills\u002F` | `.claude\u002Fskills\u002F` (default) | \n| **Invocation** | `Skill(\"name\")` tool | `npx openskills read \u003Cname>` | \n| **Marketplace** | Anthropic marketplace | GitHub (anthropics\u002Fskills) | \n| **Progressive Disclosure** | ✅ | ✅ |\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Show the exact AGENTS.md format OpenSkills writes\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n```xml\n\u003Cskills_system priority=\"1\">\n\n## Available Skills\n\n\u003C!-- SKILLS_TABLE_START -->\n\u003Cusage>\nWhen users ask you to perform tasks, check if any of the available skills below can help complete the task more effectively.\n\nHow to use skills:\n- Invoke: `npx openskills read \u003Cskill-name>` (run in your shell)\n- The skill content will load with detailed instructions\n- Base directory provided in output for resolving bundled resources\n\nUsage notes:\n- Only use skills listed in \u003Cavailable_skills> below\n- Do not invoke a skill that is already loaded in your context\n\u003C\u002Fusage>\n\n\u003Cavailable_skills>\n\n\u003Cskill>\n\u003Cname>pdf\u003C\u002Fname>\n\u003Cdescription>Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging\u002Fsplitting documents, and handling forms...\u003C\u002Fdescription>\n\u003Clocation>project\u003C\u002Flocation>\n\u003C\u002Fskill>\n\n\u003C\u002Favailable_skills>\n\u003C!-- SKILLS_TABLE_END -->\n\n\u003C\u002Fskills_system>\n```\n\n\u003C\u002Fdetails>\n\n---\n\n## 🔧 Install Skills\n\n### From Anthropic Marketplace\n\n```bash\nnpx openskills install anthropics\u002Fskills\n```\n\n### From Any GitHub Repo\n\n```bash\nnpx openskills install your-org\u002Fyour-skills\n```\n\n### From a Local Path\n\n```bash\nnpx openskills install .\u002Flocal-skills\u002Fmy-skill\n```\n\n### From Private Git Repos\n\n```bash\nnpx openskills install git@github.com:your-org\u002Fprivate-skills.git\n```\n\n---\n\n## 🌍 Universal Mode (Multi-Agent Setups)\n\nIf you use Claude Code **and** other agents with one `AGENTS.md`, install to `.agent\u002Fskills\u002F` to avoid conflicts with Claude's plugin marketplace:\n\n```bash\nnpx openskills install anthropics\u002Fskills --universal\n```\n\n**Priority order (highest wins):**\n1. `.\u002F.agent\u002Fskills\u002F`\n2. `~\u002F.agent\u002Fskills\u002F`\n3. `.\u002F.claude\u002Fskills\u002F`\n4. `~\u002F.claude\u002Fskills\u002F`\n\n---\n\n## 🧰 Commands\n\n```bash\nnpx openskills install \u003Csource> [options]  # Install from GitHub, local path, or private repo\nnpx openskills sync [-y] [-o \u003Cpath>]       # Update AGENTS.md (or custom output)\nnpx openskills list                        # Show installed skills\nnpx openskills read \u003Cname>                 # Load skill (for agents)\nnpx openskills update [name...]            # Update installed skills (default: all)\nnpx openskills manage                      # Remove skills (interactive)\nnpx openskills remove \u003Cname>               # Remove specific skill\n```\n\n### Flags\n\n- `--global` — Install globally to `~\u002F.claude\u002Fskills` (default: project install)\n- `--universal` — Install to `.agent\u002Fskills\u002F` instead of `.claude\u002Fskills\u002F`\n- `-y, --yes` — Skip prompts (useful for CI)\n- `-o, --output \u003Cpath>` — Output file for sync (default: `AGENTS.md`)\n\n---\n\n## 🧬 The SKILL.md Format\n\nOpenSkills uses Anthropic's exact format:\n\n```markdown\n---\nname: pdf\ndescription: Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging\u002Fsplitting documents, and handling forms.\n---\n\n# PDF Skill Instructions\n\nWhen the user asks you to work with PDFs, follow these steps:\n1. Install dependencies: `pip install pypdf2`\n2. Extract text using scripts\u002Fextract_text.py\n3. Use references\u002Fapi-docs.md for details\n```\n\nSkills are **loaded on demand**, keeping your agent's context clean and focused.\n\n---\n\n## 🧪 Creating Your Own Skills\n\n### Minimal Structure\n\n```\nmy-skill\u002F\n└── SKILL.md\n```\n\n### With Resources\n\n```\nmy-skill\u002F\n├── SKILL.md\n├── references\u002F\n├── scripts\u002F\n└── assets\u002F\n```\n\nInstall your own skill:\n\n```bash\nnpx openskills install .\u002Fmy-skill\n```\n\n### Local Development with Symlinks\n\n```bash\ngit clone git@github.com:your-org\u002Fmy-skills.git ~\u002Fdev\u002Fmy-skills\nmkdir -p .claude\u002Fskills\nln -s ~\u002Fdev\u002Fmy-skills\u002Fmy-skill .claude\u002Fskills\u002Fmy-skill\n```\n\n### Authoring Guide\n\n```bash\nnpx openskills install anthropics\u002Fskills\nnpx openskills read skill-creator\n```\n\n---\n\n## 🔄 Updating Skills\n\nIf you installed skills from a git repo, you can refresh them anytime:\n\n```bash\nnpx openskills update\n```\n\nTo update specific skills, pass a comma-separated list:\n\n```bash\nnpx openskills update git-workflow,check-branch-first\n```\n\nIf a skill was installed before updates were tracked, re-install it once to record its source.\n\n---\n\n## ✅ Tips\n\n- You can always run OpenSkills via `npx`; a global install is optional.\n- For multiple reads, prefer comma-separated names: `npx openskills read foo,bar`.\n\n---\n\n## ❓ FAQ\n\n### Why CLI instead of MCP?\n\n**MCP is for dynamic tools.** Skills are static instructions + resources.\n\n- Skills are just files → no server required\n- Works with every agent → no MCP support needed\n- Matches Anthropic's design → SKILL.md is the spec\n\nMCP and skills solve different problems. OpenSkills keeps skills lightweight and universal.\n\n---\n\n## 📋 Requirements\n\n- **Node.js** 20.6+\n- **Git** (for cloning repositories)\n\n---\n\n## 📜 License\n\nApache 2.0\n\n## Attribution\n\nImplements [Anthropic's Agent Skills](https:\u002F\u002Fwww.anthropic.com\u002Fengineering\u002Fequipping-agents-for-the-real-world-with-agent-skills) specification.\n\n**Not affiliated with Anthropic.** Claude, Claude Code, and Agent Skills are trademarks of Anthropic, PBC.\n","OpenSkills 是一个为AI编码助手设计的通用技能加载器。它支持多种AI编码助手如Claude Code、Cursor、Windsurf等，采用与Anthropic相同的技能系统格式，确保了广泛的兼容性。项目使用TypeScript编写，通过简单的CLI命令即可安装和同步技能库，使得技能能够按需加载，保持上下文的简洁。此外，OpenSkills还支持从本地路径或私有Git仓库安装技能，方便用户管理和版本控制。适合需要在不同AI编码工具间共享技能库的开发者以及希望扩展其AI助手功能的团队使用。",2,"2026-06-11 03:45:44","high_star"]