create-plugin

Create a Vibe Plugin

A plugin is a directory containing a plugin.json manifest (Agent Plugins 1.0 schema) plus optional component directories and config files. Vibe discovers plugins under .vibe/plugins/ (project scope, requires trusted folder) and ~/.vibe/plugins/ (user global).

Plugin discovery locations

Scope	Path	When
Project	<project>/.vibe/plugins/<name>/	trusted folder only
User global	~/.vibe/plugins/<name>/	always

Each subdirectory under a plugins root is one plugin package. The first match wins: project plugins take precedence over user plugins with the same name.

Plugin directory structure

my-plugin/
  plugin.json                 # required — Agent Plugins 1.0 manifest
  mcp.json                    # optional — MCP server definitions
  libraries.json              # optional — Node/Python library dependencies
  connectors.json             # optional — managed connector requirements
  skills/                     # optional — one subdirectory per skill
    my-skill/
      SKILL.md
  ai.mistral.vibe/            # optional — Vibe-specific extensions
    hooks.toml                # Vibe extension only
    knowledge/                # one subdirectory per knowledge folder
      topic-name/
        KNOWLEDGE.md
    agents/                   # one .toml per subagent
      researcher.toml
    INSTRUCTIONS.md           # optional plugin-wide instructions (not loaded)

Step 1 — plugin.json (required)

The manifest is a JSON file with $schema and name as required fields.

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "What this plugin provides.",
  "author": {
    "name": "Author Name",
    "email": "author@example.com",
    "url": "https://example.com"
  },
  "homepage": "https://example.com/my-plugin",
  "repository": "https://github.com/example/my-plugin",
  "license": "MIT",
  "keywords": ["productivity", "finance"],
  "extensions": {}
}

Rules:

• name must match ^[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?$ (1-64 chars), no -- or ...
• $schema must be exactly https://agent-plugins.org/schemas/1.0.0/plugin.schema.json. Any other schema URL produces a fatal plugin.schema.version_unsupported error.
• All fields other than those listed above are rejected (extra="forbid").

Step 2 — Vibe extension (optional)