{
  "markdown": "![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)\n![Version](https://img.shields.io/badge/version-0.1.1-blue.svg)\n![CI](https://github.com/hiivmind/plugin-portability/actions/workflows/ci.yml/badge.svg)\n\n# Plugin Portability\n\nA plugin for agent skill and plugin authors who have built for one platform — often Claude Code — and need to go cross-platform.\n\nPoint it at a plugin repo and it tells you what's missing. Say the word and it emits every missing artifact in place — platform manifests, context files, tool mappings, install docs, and publishing guidance. No CLI to install, no sync daemon, no registry. The agent itself is the portability engine.\n\n## How it's different\n\nThe cross-platform plugin portability space is full of [CLI tools, sync daemons, and broad frameworks](docs/competitive-landscape.md).\nThey are separate programs you install and run alongside your plugin. Most target consumers (people installing others' skills), not authors.\nThe few that do target authors only convert from Claude Code, and do so blindly — no gap analysis, no publishing guidance, no choice of target platforms.\n\nplugin-portability takes a different approach:\n\n- **It works where authors already work.** It's a plugin you install into the same agent you're already using to build your skill. No context switch, no separate CLI — assessment and uplift happen inside the authoring workflow.\n- **Analysis first.** Examines what platform artifacts exist and reports gaps before touching anything.\n- **Any platform as input.** Not locked to Claude Code as the starting point. A Cursor plugin, a Codex skill, a bare SKILL.md — all valid inputs.\n- **Optional uplift in place.** Emits missing artifacts directly into the project in each platform's native format. No intermediate representation, no `.agents/` directory to maintain.\n- **Publishing guidance included.** Generates PUBLISHING.md with per-platform steps for getting discovered and installed — not just the artifacts, but how to ship them.\n\n## What it does\n\nStarting from whatever platform manifests already exist, it detects plugin metadata and generates everything missing:\n\n| Platform | Artifacts |\n| -------- | --------- |\n| **Claude Code** | `.claude-plugin/plugin.json`, `.claude-plugin/marketplace.json` |\n| **Cursor** | `.cursor-plugin/plugin.json` |\n| **Gemini CLI** | `gemini-extension.json`, `GEMINI.md` |\n| **Codex** | `.codex-plugin/plugin.json` |\n| **Antigravity** | `package.json`, `.agents/skills/` |\n| **OpenClaw** | `openclaw.plugin.json` |\n\n## Skills\n\n- **`plugin-portability`** — Assess or uplift a plugin for multi-platform portability. Asks intent upfront (assess/uplift, platforms, uplift target), runs condition-driven scoring, and optionally generates missing artifacts.\n\n## Ecosystem landscape\n\nCross-platform portability has real structural limits — but the ecosystem is maturing fast.\nFor consumers and single-skill authors, tools like `npx skills`, `gh skill`, and platform-native CLIs make distribution easy.\nThe friction appears when delivering cross-platform plugins with shared resources (hooks, manifests, context files).\nThe `plugin-portability` skill generates everything that *can* be generated.\nFor the full picture — what works, what doesn't, and what needs platform-level changes — see [`docs/ecosystem-landscape.md`](docs/ecosystem-landscape.md).\n\n## Acknowledgements\n\nThis plugin owes a direct debt to [obra/superpowers](https://github.com/obra/superpowers) by Jesse Vincent.\nSuperpowers pioneered the multi-platform plugin pattern for Claude Code — the manifest structures, context file conventions,\ntool-mapping references, and hook portability approach that plugin-portability now automates all originate there.\nTemplates in this repo are seeded from superpowers v5.0.7 (see [`lib/templates/UPSTREAM.md`](lib/templates/UPSTREAM.md) for re-seeding instructions).\nBeyond patterns, superpowers was used directly to build this plugin — the skills that wrote plugin-portability were themselves superpowers skills.\n\n## This repo is itself an example\n\n`plugin-portability` is structured using the exact pattern it produces. Check the root-level manifests as a reference.\n\n## Installation\n\nFull details for all platforms in [INSTALL.md](INSTALL.md).\n\n**Claude Code** — register the marketplace, then install:\n\n```text\n/plugin marketplace add hiivmind/plugin-portability\n/plugin install plugin-portability@plugin-portability-marketplace\n```\n\n**Cursor** — in Agent chat:\n\n```text\n/add-plugin plugin-portability@https://github.com/hiivmind/plugin-portability\n```\n\n**Gemini CLI:**\n\n```bash\ngemini extensions install https://github.com/hiivmind/plugin-portability\n```\n\n**Codex:**\n\n```bash\ncodex plugin marketplace add hiivmind/plugin-portability\n```\n\nThen open `/plugins` in Codex and install `plugin-portability`.\n\n**Antigravity:**\n\n```bash\ngit clone https://github.com/hiivmind/plugin-portability\ncp -R plugin-portability/.agents/skills/plugin-portability .agents/skills/\n```\n\n**OpenClaw:**\n\n```bash\nopenclaw plugins install plugin-portability\n```\n\n## Usage\n\n| Platform | Invocation |\n| -------- | ---------- |\n| **Claude Code** | `Use the plugin-portability skill on /path/to/plugin` |\n| **Cursor** | `Skill: plugin-portability` |\n| **Gemini CLI** | `activate_skill: plugin-portability` |\n| **Codex** | `$plugin-portability` |\n| **Antigravity** | Auto-discovered |\n| **OpenClaw** | Auto-discovered |\n",
  "bytes": 5405,
  "sha": "91eca53604259ad8b002826613dd844bf3a1eaa27faaf726013dcc54e35d037f",
  "repo_slug": "hiivmind/plugin-portability",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_hiivmind_plugin_portability_6fd2efac/readme"
}