OpenParable
Skip to content
← Back to skills

Create Vibe Feature

Development
create-vibe-feature

Create Vibe Feature is an Agent Skill for development published in the mistralai/mistral-vibe repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Add or modify a feature in the Mistral Vibe Python CLI while following the app architecture ADRs. Use when working in vibe/core, vibe/cli, vibe/acp, vibe/setup, built-in tools, config, sessions, skills, hooks, MCP, connectors, or other Vibe feature code.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/mistralai/mistral-vibe/blob/HEAD/.vibe/skills/create-vibe-feature/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/create-vibe-feature, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Create Vibe Feature

Use this skill when implementing Vibe feature work. Keep changes scoped, architecture-aware, and consistent with nearby code.

App Areas

AreaRolePath
Core engineAgent loop, domain events, tools, LLM backends, config, sessions, skills, hooks, telemetry types, shared modelsvibe/core/
Textual CLIInteractive terminal UX, widgets, slash commands, manual shell commands, voice UI, local user affordancesvibe/cli/
ACP bridgeAgent Client Protocol session, tool, terminal, title, and content translationvibe/acp/
SetupFirst-run, auth, onboarding, trusted folders, update promptsvibe/setup/
TestsUnit, integration, e2e, Textual snapshots, stubs and fixturestests/

Architecture Routing

Before implementation, read the matching ADRs:

  • Architecture principles, module boundaries, startup/runtime speed, simple changes: docs/adr/0001-architecture-principles.md
  • Core engine vs delivery surfaces: docs/adr/0002-core-engine-and-delivery-surfaces.md
  • Agent loop orchestration, streaming, events, cancellation, responsiveness: docs/adr/0003-event-driven-agent-loop.md
  • Tool contracts, permissions, output, UI metadata, adapters: docs/adr/0004-typed-permissioned-tools.md
  • Config models, layering, defaults, migrations, reloads: docs/adr/0005-layered-configuration.md
  • Session logging, resume, rewind, transcript metadata, migrations: docs/adr/0006-local-sessions.md
  • Skills, agents, subagents, hooks, MCP, connectors, custom tools, discovery: docs/adr/0007-extension-mechanisms.md
  • Feature work, telemetry events, analytics properties, instrumentation verification: docs/adr/0008-feature-instrumentation.md

If a change fits the current code but conflicts with ADR direction, flag it to the user before implementing.

Workflow

  1. Read README.md, AGENTS.md, and the nearest relevant source files before editing.
  2. Identify the owning area. Keep UI behavior in vibe/cli, ACP translation in vibe/acp, setup flow in vibe/setup, and reusable engine behavior in vibe/core.
  3. Study one or two existing features with the same shape before adding new files. Match naming, model placement, port/adapters, tests, and error patterns.
  4. Prefer a small change in the owning module. Add a port or abstraction only when it protects a meaningful boundary or makes replacement/testing easier.
  5. For feature work, plan telemetry with instrument-feature-analytics before writing tracking code.
  6. Keep startup and interactive latency in mind. Avoid eager imports, broad scans, and network or subprocess work unless the configured feature needs them.
  7. Update docs or built-in skill guidance when the feature changes user-visible CLI behavior, config, commands, agents, persistence, or discovery.

Consistency Checks

  • Core code should not import Textual, ACP schemas, setup UI, or other delivery-surface details.
  • Surface code should adapt core events/models instead of reaching into private core state.
  • External data should enter through Pydantic validation, typed events, tool args/results, config models, or explicit ports.
  • Tools should follow BaseTool with typed args, result, config, state, and permission behavior.
  • Tests should mirror the source layout and use existing fixtures or tests/stubs/Fake* doubles.

Verification

After Python changes, run:

uv run ruff format .
uv run ruff check --fix .

For behavior changes, run the narrowest relevant tests first, then broader checks if the change touches shared contracts:

uv run pytest <path-or-test>
uv run pyright