# Add Plugin

> Guide for adding a new plugin to this marketplace. Use when creating or scaffolding a new plugin. Use when this capability is needed.

- Skill: `tomevault-io/add-plugin` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/add-plugin`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/add-plugin/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/add-plugin

---


# Plugin Development Guide

Guide for adding a new plugin to this marketplace.

## Directory Structure

```
plugins/<plugin-name>/
├── .claude-plugin/
│   └── plugin.json      # Required: name, description, version
├── skills/
│   └── <skill-name>/
│       └── SKILL.md     # Skill definition
└── scripts/             # Complex logic as bash scripts
    └── *.sh
```

## plugin.json Required Fields

```json
{
  "name": "plugin-name",
  "description": "Plugin description",
  "version": "0.1.0"
}
```

## SKILL.md Structure

```markdown
---
name: skill-name
description: Skill description
---

# Skill Instructions

Detailed instructions for what the skill should do.
```

## Register in marketplace.json

Add the new plugin to `.claude-plugin/marketplace.json`:

```json
{
  "plugins": [
    {
      "name": "new-plugin",
      "source": "./plugins/new-plugin",
      "description": "Plugin description"
    }
  ]
}
```

## Testing

```bash
claude --plugin-dir ./plugins/<plugin-name>
```

## Using Complex Scripts

When complex logic is needed:

1. Create bash scripts in `scripts/` directory
2. Reference script execution in SKILL.md
3. Only script output goes to context, making it token-efficient

## Reference

Read the official documentation for more details.

### Official Documentation

- Create plugins: https://code.claude.com/docs/en/plugins
- Agent skills:
  https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/powdream) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->