# Vibe Plugin Scaffolding

Scaffolds a Mistral Vibe plugin with skills, MCP servers, hooks and connectors.

- Repository: https://github.com/mistralai/mistral-vibe (5270 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add mistralai/mistral-vibe --skill create-plugin -g -a claude-code -y`
Codex: `npx skills add mistralai/mistral-vibe --skill create-plugin -g -a codex -y`
Cursor: `npx skills add mistralai/mistral-vibe --skill create-plugin -g -a cursor -y`
Gemini CLI: `npx skills add mistralai/mistral-vibe --skill create-plugin -g -a gemini-cli -y`

## Description

Create a Vibe plugin package, the Agent Plugins 1.0 format with optional Vibe extensions for skills, MCP servers, hooks, knowledge, agents, libraries, and connectors. Use when the user wants to create, scaffold, or author a plugin for Mistral Vibe.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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.

The rest: https://github.com/mistralai/mistral-vibe/blob/HEAD/vibe/plugins/builtins/vibe/skills/create-plugin/SKILL.md