Mistral Vibe: Builtin Skills System with Self-Awareness

Mistral Vibe Gets Self-Awareness: A Builtin Skills System Lands in v2.8.0

Mistral Vibe's v2.8.0 release, shipped on April 21, 2026, introduces a significant extension to the skills architecture: a builtin skills system that ships fully packaged skills alongside the agent itself. The first builtin skill delivered is the self-awareness skill, internally named vibe.

What Are Builtin Skills?

Until v2.8.0, all skills in Mistral Vibe were user-defined — developers wrote SKILL.md files, placed them in designated discovery directories (.vibe/skills/, ~/.vibe/skills/, or custom paths), and the SkillManager loaded them at startup. Builtin skills work differently: they are defined directly in the Mistral Vibe source code under vibe/core/skills/builtins/ as SkillInfo Python objects, and are merged into the skill registry before any user-level skill discovery. This means they are always available out of the box, with no file system setup required, while still respecting the enabled_skills and disabled_skills filter configuration.

The Self-Awareness Skill: The Agent Knows Itself

The vibe builtin skill gives the agent "full knowledge of the application internals so you can help the user understand, configure, and troubleshoot their Vibe installation." In practice, this means the agent carries a complete reference document — loaded as skill context — covering:

VIBE_HOME Directory Layout

The skill maps the entire ~/.vibe/ structure: config.toml, .env, vibehistory, trusted_folders.toml, and all subdirectories including agents/, prompts/, skills/, tools/, logs/, and plans/. It also covers project-local configuration under .vibe/ in trusted project folders.

Full Configuration Schema

Every config.toml key is documented with its default value and effect — from model selection (active_model, [[models]] blocks) to UI preferences (vim_keybindings, disable_welcome_banner_animation), behavior flags (auto_approve, auto_compact_threshold, api_timeout), and voice settings (voice_mode_enabled, active_tts_model). Provider and MCP server configuration are also covered.

CLI Parameters and Built-in Commands

The skill includes a complete reference for all CLI invocation flags (--agent, --workdir, --continue, --resume, --max-turns, --max-price, --output) and all built-in slash commands (/config, /model, /reload, /clear, /debug, /compact, /rewind, /mcp, /voice, /data-retention, /leanstall, and others).

Agents, Subagents, and Filter Patterns

The built-in agents (default, plan, accept-edits, auto-approve, lean) and the read-only explore subagent are described, along with the three-mode matching system (exact, glob, regex) used by enabled_skills, disabled_skills, enabled_tools, and disabled_tools.

Why This Matters

Before this release, users asking "how do I disable web search?" or "where are my custom agents stored?" received generic answers based on whatever the underlying model absorbed during training — potentially outdated or inaccurate for their installed version. With the self-awareness skill, the agent consults an authoritative, version-accurate reference that ships with the release itself.

This approach also establishes a pattern for future first-party knowledge delivery. Mistral Vibe can now package curated domain expertise — debugging guides, bootstrapping workflows, model-switching heuristics — directly as builtin skills, without requiring users to manage any skill files themselves.

Other Changes in v2.8.0

Beyond the builtin skills system, v2.8.0 adds /connectors as an alias for the /mcp command with a new R keyboard shortcut to refresh the MCP server list, and a cwd configuration parameter for MCP stdio servers. The /terminal-setup command was removed. A same-day patch (v2.8.1) corrected the changelog and whats_new.md display output.