Install a plugin bundle, add a custom MCP server, or upload a skill [write]

Changed on

multipart/form-data uploads a skill exactly as POST /skills did (one zip or individual files, SKILL.md at the root): its first revision, answered as {skill, revision}. source is github:owner/repo[/path][@ref] or a github.com URL to a folder in Claude Code's plugin format (.claude-plugin/plugin.json, skills/, commands/, .mcp.json). skills/<name>/ become workspace skills as they are and commands/<name>.md become skills whose SKILL.md is the command's prompt, all attached to every new session. Installing again updates in place: kept parts get a new revision, dropped parts are deleted (or switched off when a session holds them). Sub-agents, hooks and local MCP servers are listed under skipped. connectors lists each .mcp.json server, the AgentSky connector app it maps to, whether the caller has that connection, and the link to connect it.

post/plugins

Request

  • Base URL
    https://api.agentsky.dev/v1
  • URL
    https://api.agentsky.dev/v1/plugins
  • Auth
    HTTP bearer

Request body

OR

Example request

{
  "source": "github:owner/repo/plugins/review@main"
}

Response

Installed; a multipart upload answers {skill, revision}: the new skill:<id> plugin and its first revision

Changes