Plugins & skills
DOCS / WORK WITH VIBES

Plugins & skills

Extend what Vibes can do without expanding its core agent loop.

Capabilities are plugins

Plugins contribute tools and lifecycle behavior. The flagship createVibeAgent assembles the default set; the core agent coordinates them.

PluginResponsibility
FilesystemPlugin / BashPluginFiles and real command execution.
PlanningPlugin / ModePluginPlans, task state, and execution policy.
SubAgentPluginFocused workers and runtime specialists.
MemoryPlugin / SummarizationPluginWorking memory and context management.
ArtifactPluginRenderable outputs and stored artifacts.
ClarificationPluginStructured questions that pause a run.
SkillsPlugin / RepoContextPluginLoad skills and project guidance.
WebSearchPlugin / GuardrailsPluginOptional search and output checks.

The lifecycle

prepareTurn adjusts a model call. modifySystemPrompt contributes instructions. onStreamReady and onStreamFinish observe streaming. waitReady supports initialization, and onInputAvailable handles tool input.

The older prepareStep name remains a compatibility alias. Prefer the vocabulary used in the current plugin interface at src/core/agent/plugin-api.ts.

Skills are written instructions

Skills are human-authored SKILL.md files that the agent discovers and activates. Configure a skills directory with SKILLS_DIR when running the API.

Project guidance from AGENTS.md and CLAUDE.md is loaded by the repository-context plugin. Keep these documents specific to the codebase.

MCP is opt-in

McpPlugin ships in the harness package and can expose connected MCP server tools. It is not included in the default flagship plugin roster. Add it deliberately when assembling an agent that needs those connections.

Improve this page Grounded in the Vibes source.

Find a guide, command, or concept.