Skip to content
Back to search

OpenPackage

The open, universal, coding agent skills, agents, rules, and commands organizer and package manager.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/enulus--openpackage/badge.svg)](/listings/enulus--openpackage)

HTML

<a href="/listings/enulus--openpackage"><img src="/api/listings/enulus--openpackage/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npm

npm install -g opkg 

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 286 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <a href="https://github.com/enulus/OpenPackage">
  3. <picture>
  4. <source srcset="assets/openpackage_ascii_dark.png" media="(prefers-color-scheme: dark)">
  5. <source srcset="assets/openpackage_ascii_light.png" media="(prefers-color-scheme: light)">
  6. <img src="assets/openpackage_ascii_light.png" alt="OpenPackage logo" height="84">
  7. </picture>
  8. </a>
  9. </p>
  10. <p align="center">The package manager for coding agent configs.</p>
  11. <p align="center">
  12. <a href="https://www.npmjs.com/package/opkg " target="blank">
  13. <img src="https://img.shields.io/npm/v/opkg?style=flat-square" alt="Npm package for OpenPackage">
  14. </a>
  15. <a href="./LICENSE">
  16. <img alt="License: Apache-2.0" src="https://img.shields.io/github/license/enulus/openpackage?style=flat-square" />
  17. </a>
  18. <a href="https://discord.gg/W5H54HZ8Fm" target="blank">
  19. <img src="https://img.shields.io/badge/Discord-Join%20the%20community-5865F2?logo=discord&logoColor=white&style=flat-square" alt="OpenPackage Discord">
  20. </a>
  21. <br /><br />
  22. </p>
  23. <p align="center">
  24. Follow <a href="https://x.com/hyericlee">@hyericlee on X</a> for updates · Join the <a href="https://discord.gg/W5H54HZ8Fm">OpenPackage Discord</a> for help and questions.
  25. </p>
  26. # OpenPackage
  27. OpenPackage enables simple, modular management of coding agent configs, providing unified installation, management, and packaging of rules, commands, agents, skills, and MCPs for any platform, any codebase.
  28. ## Why OpenPackage?
  29. Modern AI coding tools are powerful and efficient when rules, commands, subagents, and skills are properly setup. Unfortunately, these files remain difficult to organize and manage.
  30. OpenPackage provides a centralized and universal interface for installing, uninstalling, and packaging coding agent config files for simplified management and distribution.
  31. - **Simplified config management** - Install & uninstall rules, commands, agents, skills and MCPs with a single command
  32. - **Consistent dependencies** - Declare and package sets of config files for organization and reuse
  33. - **Universal compatability** - Built in cross-platform conversions and install target resolutions
  34. - **Community driven** - Compose packages together to create powerful workflows that continuously evolve
  35. ## Use cases
  36. - Install Agents, Skills, and Claude Plugins to any coding platform
  37. - Sync rules, commands, agents, skills, and MCPs across platforms
  38. - Reuse files and configs across multiple codebases
  39. - Simplified, modular management and install/uninstall of configs and specs
  40. ## How it works
  41. At its core, OpenPackage is a lightweight CLI package manager that performs installs and uninstalls of config files, with the ability to keep track of file sources and dependencies, plus packaging capabilities.
  42. It's basically a much more powerful, universal, and open source version of Vercel Skills and Claude Code Plugins.
  43. ## Install OpenPackage
  44. npm
  45. ```bash
  46. npm install -g opkg
  47. ```
  48. ## Quick start
  49. ### Install resources
  50. ```bash title="Terminal"
  51. opkg install <resource>
  52. ```
  53. Installs all files from a specified resource into the codebase at cwd, formatted and converted to per platform conventions and into their respective dirs.
  54. #### Install resources (packages, plugins, rules, commands, agents, and skills)
  55. ```bash title="Terminal"
  56. # OpenPackage local or remote packages
  57. opkg install <package-name>
  58. # Github repos
  59. opkg install gh@<owner>/<repo>
  60. # GitHub URLs
  61. opkg install https://github.com/<owner>/<repo>/<path-to-resource>
  62. # Local path to package or Claude Plugin
  63. opkg install <path-to-dir>
  64. # Git URLs (HTTPS, SSH, .git#ref)
  65. opkg install https://gitlab.com/<org>/<repo>.git
  66. opkg install git@<host>:<org>/<repo>.git
  67. opkg install ssh://git@<host>/<org>/<repo>.git#<ref>
  68. # Examples
  69. opkg install essentials
  70. opkg install gh@anthropics/claude-code --plugins code-review
  71. opkg install gh@wshobson/agents --plugins ui-design --agents ui-designer
  72. opkg install gh@wshobson/agents/plugins/ui-design/agents/ui-designer
  73. opkg install gh@vercel-labs/agent-skills --skills react-best-practices
  74. opkg install https://github.com/anthropics/claude-code/tree/main/plugins/code-review
  75. opkg install https://github.com/wshobson/agents/tree/main/plugins/ui-design/agents/ui-designer.md
  76. opkg install https://github.com/vercel-labs/agent-skills/tree/main/skills/react-best-practices
  77. ```
  78. #### Options
  79. | Option | Description |
  80. | --- | --- |
  81. | `-g, --global` | Install to home directory (~/) instead of current workspace |
  82. | `-s, --skills <skills...>` | Install specific skills by name |
  83. | `-a, --agents <agents...>` | Install specific agents by name |
  84. | `-c, --commands <commands...>` | Install specific commands by name |
  85. | `-r, --rules <rules...>` | Install specific rules by name |
  86. | `--plugins <plugins...>` | Install specific plugins by name |
  87. | `--platforms <platforms...>` | Install to specific platforms (e.g., cursor claudecode opencode) |
  88. | `-i, --interactive` | Interactively select resources to install |
  89. | `--dev` | Add resource to dev-dependencies |
  90. | `--remote` | Pull and install from remote registry, ignoring local versions |
  91. | `--local` | Resolve and install using only local registry versions |
  92. ### List installed resources
  93. ```bash title="Terminal"
  94. opkg list # Lists resources installed to workspace at cwd
  95. opkg list <package> # Lists installed files for specified resource
  96. ```
  97. Use the list command to show an overview of packages and files installed.
  98. #### Options
  99. | Option | Description |
  100. | --- | --- |
  101. | `-s, --scope <scope>` | Workspace scope: project or global (default: both) |
  102. | `--flat` | List packages at root level without nesting |
  103. | `-f, --files` | Show individual file paths |
  104. | `-t, --tracked` | Show only tracked resources (skip untracked scan) |
  105. | `-u, --untracked` | Show only untracked resources |
  106. | `--platforms <platforms...>` | Filter by specific platforms (e.g., cursor, claude) |
  107. ### Uninstall packages
  108. ```bash title="Terminal"
  109. opkg uninstall <package>
  110. ```
  111. Removes all files for a package from the codebase at cwd.
  112. #### Options
  113. | Option | Description |
  114. | --- | --- |
  115. | `-g, --global` | Uninstall from home directory (~/) instead of current workspace |
  116. | `-i, --interactive` | Interactively select items to uninstall |
  117. > [!TIP]
  118. > Learn more by heading over to the [official docs](https://openpackage.dev/docs).
  119. ### Compose packages
  120. ```bash title="Terminal"
  121. opkg new <package>
  122. ```
  123. #### Options
  124. | Option | Description |
  125. | --- | --- |
  126. | `--scope <scope>` | Package scope: root, project, or global (default: global) |
  127. | `--path <path>` | Custom path for package directory (overrides scope) |
  128. Then manually add/update/remove files to and from the package following this structure:
  129. ```txt title="Structure"
  130. <package>
  131. │
  132. │ # Package files
  133. ├── openpackage.yml # The OpenPackage manifest, required
  134. ├── README.md # LICENSE.md, CONTRIBUTING.md, etc.
  135. │
  136. │ # Content files
  137. ├── rules/ # Rule files
  138. ├── commands/ # Command files (slash commands)
  139. ├── agents/ # Agent files (subagents)
  140. ├── skills/ # Skill files (skills)
  141. ├── root/ # Any other root dirs or files (Ex: specs/, docs/, tests/, etc.)
  142. ├── AGENTS.md # Platform root file
  143. ├── mcp.jsonc # MCP config file
  144. │
  145. │ # Custom files
  146. └── <other> # Customizable via `platforms.jsonc` overrides/extensions
  147. ```
  148. You can also use the `add` and `remove` commands to add/remove files to/from a package.
  149. ```bash title="Terminal"
  150. opkg add --to <package> # Interactively select files from cwd to add to package
  151. opkg add .cursor/commands/clean.md --to <package> # Adds workspace file or dir to package
  152. opkg remove --from <package> # Interactively select files from package to remove
  153. opkg remove commands/clean.md --from <package> # Removes file or dir from package
  154. ```
  155. #### `add` options
  156. | Option | Description |
  157. | --- | --- |
  158. | `--to <package-name>` | Target package (for dependency: which manifest; for copy: which package source) |
  159. | `--dev` | Add to dev-dependencies instead of dependencies |
  160. | `--copy` | Force copy mode (copy files instead of recording dependency) |
  161. | `--platform-specific` | Save platform-specific variants for platform subdir inputs |
  162. #### `remove` options
  163. | Option | Description |
  164. | --- | --- |
  165. | `--from <package-name>` | Source package name (defaults to workspace package) |
  166. > [!TIP]
  167. > Learn more about packages from the [packages doc](https://openpackage.dev/docs/packages) on our official docs.
  168. ## Supported Platforms & Files
  169. OpenPackage performs installation and platform sync of files for supported AI coding platforms outlined by the table below.
  170. | Platform | Directory | Root file | Rules | Commands | Agents | Skills | MCP |
  171. | --- | --- | --- | --- | --- | --- | --- | --- |
  172. | AdaL | .adal/ | | | | | skills/ | settings.json |
  173. | Amp | .agents/ | | checks/ | | | skills/ | .amp/settings.json |
  174. | Antigravity | .agent/ | | rules/ | workflows/ | | skills/ | |
  175. | Augment Code | .augment/ | | rules/ | commands/ | | skills/ | |
  176. | Claude Code | .claude/ | CLAUDE.md | rules/ | commands/ | agents/ | skills/ | .mcp.json (root) |
  177. | Claude Code Plugin | .claude-plugin/ | | rules/ | commands/ | agents/ | skills/ | .mcp.json (root) |
  178. | Cline | .cline/ | | | | | skills/ | cline_mcp_settings.json |
  179. | CodeBuddy | .codebuddy/ | | rules/ | | | skills/ | |
  180. | Codex CLI | .codex/ | | | prompts/ | agents/ | skills/ | config.toml |
  181. | Command Code | .commandcode/ | | | commands/ | agents/ | skills/ | |
  182. | Continue | .continue/ | | rules/ | prompts/ | | skills/ | |
  183. | Crush | .config/crush/ | | | | | skills/ | crush.json (root) |
  184. | Cursor | .cursor/ | | rules/ | commands/ | agents/ | skills/ | mcp.json |
  185. | Factory AI | .factory/ | | | commands/ | droids/ | skills/ | settings/mcp.json |
  186. | GitHub Copilot | .github/ | | | | agents/ | skills/ | |
  187. | Goose | .goose/ | | | | | skills/ | config.yaml |
  188. | iFlow CLI | .iflow/ | IFLOW.md | | commands/ | agents/ | skills/ | settings.json |
  189. | Junie | .junie/ | | | | | skills/ | |
  190. | Kilo Code | .kilocode/ | | rules/ | workflows/ | | skills/ | mcp.json |
  191. | Kimi Code CLI | .agents/ | | | | | skills/ | .kimi/mcp.json |
  192. | Kiro | .kiro/ | | steering/ | | | skills/ | settings/mcp.json |
  193. | Kode | .kode/ | | | | | skills/ | |
  194. | MCPJam | .mcpjam/ | | | | | skills/ | |
  195. | Mistral Vibe | .vibe/ | | | | | skills/ | |
  196. | Mux | .mux/ | | | | | skills/ | |
  197. | Neovate | .neovate/ | | | | | skills/ | mcp.json |
  198. | OpenClaw | .openclaw/ | | | | | skills/ | |
  199. | OpenCode | .opencode/ | | | commands/ | agents/ | skills/ | opencode.json |
  200. | OpenHands | .openhands/ | | | | | skills/ | mcp.json |
  201. | Pi-Mono | .pi/ | | | agent/prompts/ | | agent/skills/ | |
  202. | Pochi | .pochi/ | | | | | skills/ | |
  203. | Qoder | .qoder/ | | rules/ | commands/ | agents/ | skills/ | |
  204. | Qwen Code | .qwen/ | QWEN.md | | | agents/ | skills/ | settings.json |
  205. | Replit | .agents/ | replit.md | | | | skills/ | |
  206. | Roo Code | .roo/ | | | commands/ | | skills/ | mcp.json |
  207. | Trae | .trae/ | | rules/ | | | skills/ | |
  208. | Trae CN | .trae-cn/ | | rules/ | | | skills/ | |
  209. | Warp | .warp/ | WARP.md | | | | | |
  210. | Windsurf | .windsurf/ | | rules/ | | | skills/ | |
  211. | Zencoder | .zencoder/ | | | | | skills/ | |
  212. The built-in `platforms.jsonc` defines supported platforms, but can be overridden by user configs:
  213. - Global: `~/.openpackage/platforms.jsonc` (`.json`)
  214. - Workspace: `<cwd>/.openpackage/platforms.jsonc` (`.json`)
  215. Deep-merged (local > global > built-in) for per-project customization.
  216. ## Contributing
  217. We would love your help building a more open source and universally compatible agentic coding ecosystem.
  218. Feel free to create [PRs](https://github.com/enulus/OpenPackage/pulls) and [Github issues](https://github.com/enulus/OpenPackage/issues) for:
  219. - Bugs
  220. - Feature requests
  221. - Support for new platforms
  222. - Missing standard behavior
  223. - Documentation
  224. ## Links
  225. - [Official Website and Registry](https://openpackage.dev)
  226. - [Documentation](https://openpackage.dev/docs)
  227. - [Discord](https://discord.gg/W5H54HZ8Fm)
  228. - [Creator X (Twitter)](https://x.com/hyericlee)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.