Build Agent Plugins

Build Agent Plugins

Use this skill to create, migrate, package, and inspect Agent Plugins.

When to Use

Use this skill when you need to:

• Create a new Agent Plugin from scratch
• Migrate from Claude Code, Cursor, Codex, OpenCode, or VS Code
• Validate and package an existing plugin
• Inspect a plugin's structure

Commands

Create a new plugin

# Interactive
bun packages/cli/bin/agent-plugins init

# From flags
bun packages/cli/bin/agent-plugins create --name my-plugin --skills-only

Migrate from existing setup

# Auto-detect source format
bun packages/cli/bin/agent-plugins migrate ./my-project

# Specify source format
bun packages/cli/bin/agent-plugins migrate ./my-project --from claude

Validate and package

bun packages/cli/bin/agent-plugins package ./my-plugin

Inspect a plugin

bun packages/cli/bin/agent-plugins inspect ./my-plugin

Examples

Create a skills-only plugin

bun packages/cli/bin/agent-plugins create \
  --name my-skills \
  --skills-only \
  --output ./my-skills-plugin

Migrate from Claude Code

bun packages/cli/bin/agent-plugins migrate \
  ./my-claude-project \
  --from claude \
  --output ./my-agent-plugin

Validate a plugin

bun packages/cli/bin/agent-plugins package ./my-plugin --dry-run

Output Structure

Generated plugins follow this structure:

my-plugin/
├── plugin.json
├── skills/
│   └── skill-name/
│       └── SKILL.md
└── mcp.json (optional)

Migration Report

When migrating, the tool reports:

• ✓ Portable components (migrated)
• ⚠ Client-specific components (not migrated)
• ✗ Unsupported components (not migrated)