# Build Agent Plugins

> Create, migrate, package, and inspect Agent Plugins for modern AI agents

- Skill: `hiai-gg/build-agent-plugins` (Agent Skill)
- Install (CLI): `npx skillmds@latest add hiai-gg/build-agent-plugins`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hiai-gg/build-agent-plugins/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: HiAi-gg (https://skillmd.com/u/hiai-gg)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hiai-gg/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

```bash
# 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

```bash
# 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

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

### Inspect a plugin

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

## Examples

### Create a skills-only plugin

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

### Migrate from Claude Code

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

### Validate a plugin

```bash
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)