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.
| Plugin | Responsibility |
|---|---|
| FilesystemPlugin / BashPlugin | Files and real command execution. |
| PlanningPlugin / ModePlugin | Plans, task state, and execution policy. |
| SubAgentPlugin | Focused workers and runtime specialists. |
| MemoryPlugin / SummarizationPlugin | Working memory and context management. |
| ArtifactPlugin | Renderable outputs and stored artifacts. |
| ClarificationPlugin | Structured questions that pause a run. |
| SkillsPlugin / RepoContextPlugin | Load skills and project guidance. |
| WebSearchPlugin / GuardrailsPlugin | Optional 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.