plugin-porting

Plugin Porting

A PenguinHarness plugin is an npm package installed on the server and shared by every Project: the Plugins page shows its card, and anyone installs it on an Agent from there ("Manage installs"), which writes its skills and adds its MCP servers to that Agent's tools. This skill turns a plugin written for another tool into that package: fetch the source at a pinned commit, recognise its layout, build the package in a scratch folder by the rules below, review it, install it with the CLI, verify. To put a few skills into this Agent alone instead, use the skill-porting skill.

Before you start

• If the message only names this skill, ask for the source: a GitHub link (a repository, a folder, or a file inside the plugin's folder), a Codex or Claude Code plugin name, or a local folder.
• Installing puts the package on the whole server with the administrator's authority that the CLI's local token carries. Its skills become standing instructions for every Agent that installs it, so the review below is not optional.
• Work in a scratch folder (mktemp -d). Never write into the server's data root by hand: penguin plugin install is the only way in.
• Keep the conversation small: list trees with find, read files with sed -n '1,120p', and never cat a whole tree.

The package format

<folder>/
├── package.json             # the manifest (below)
├── README.md                # optional; the plugin's detail dialog shows it
├── icon.svg                 # optional; the card's icon
└── skills/<name>/SKILL.md   # one directory per skill, with the text files it refers to

{
  "name": "@ported/<name>",
  "version": "1.0.0",
  "description": "English one-line description.",
  "keywords": ["penguin-plugin", "ported"],
  "author": "Upstream author",
  "homepage": "https://…",
  "repository": { "type": "git", "url": "https://github.com/<owner>/<repo>", "directory": "<path>" },
  "license": "MIT",
  "penguin": {
    "title": "Display Name",
    "short_description": "One short line for the card.",
    "category": "software-development",
    "icon": "icon.svg",
    "quick_start": { "prompt": "A first request that shows the plugin working." },
    "mcp_servers": [
      {
        "name": "cloudflare-api",
        "config": {
          "transport": "http",
          "url": "https://mcp.cloudflare.com/mcp",
          "headers": { "Authorization": "Bearer ${CLOUDFLARE_API_TOKEN}" },
          "oauth": {}
        },
        "setup": [{ "key": "CLOUDFLARE_API_TOKEN", "label": "Cloudflare API token" }]
      }
    ]
  }
}