Customize an installed workspace capability, a bundle of agent tools and guidance. It updates the configuration to add MCP servers, which connect agents to tools, or change skills, integrations, and instructions while preserving existing settings.
Guide for modifying an already-installed workspace capability — adding or editing its MCP servers, skills, integrations, or agent guidance. Use when the user wants to customize, change, or extend an existing capability.
Review the instructions the agent will receive before you install.
Modify a capability that is already installed in this workspace. The most common request is giving it an MCP server so its agent gains new tools, but the same flow covers adding skills, integrations, or guidance.
A capability's source of truth is its manifest at
capabilities/<capability-id>/capability.yaml. Re-installing reads that manifest
and upserts the capability — re-install IS the update mechanism, and it never
creates a duplicate.
capabilities/<capability-id>/capability.yaml exists, edit it in place.ref), its integrations, and its
agent_prompt, then add your change on top.capability_install tool with capability_id: <capability-id>.
It re-reads the manifest and upserts the capability. A malformed manifest is
rejected with a precise error — fix and retry.Add an mcp: block to the manifest. Each server connects the capability's agent
to an MCP endpoint and exposes the tools you list.
Remote server (an HTTP/SSE MCP endpoint):
mcp:
servers:
- id: x # letters/digits/_/-, unique in this capability
type: remote
url: https://mcp.example/sse
headers: # optional — e.g. auth
Authorization: Bearer <token>
tools: [create_post, list_posts] # which tools to expose (required, ≥1)
Local server (a subprocess speaking MCP over stdio):
mcp:
servers:
- id: helper
type: local
command: [npx, "-y", "@modelcontextprotocol/server-everything"]
environment: # optional
SOME_TOKEN: "{env:SOME_TOKEN}" # reads from the runtime environment
tools: [echo, add]
Rules:
tools must list at least one tool name — you declare exactly which tools to expose.url; local servers require command.headers (remote) or environment (local). Both header and
environment values may use {env:VAR_NAME} to read from the runtime environment
instead of hard-coding secrets.The exposed tools become available to the capability's agent on the next run.
Confirm what you changed and remind the user to start a new message so the agent picks up the new MCP tools.
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Build holaOS apps for connecting external services or managing work through a dashboard. The skill uses shared SDK building blocks for stored records, actions, and synchronization, with the dashboard and agent tools working on the same data.
Analyze audience demographics and engagement to identify distinct groups, understand what they want, and prioritize valuable segments. Turn those findings into recommendations for content topics, formats, posting times, and tone, while explaining limits in the data.
Guide an agent through efficient use of an embedded browser by choosing targeted actions, searches, and waits. Reduce repeated tool calls and unnecessary page snapshots, while using more detailed inspection when the target or result remains unclear.
Validate workflows and reproduce issues in an embedded browser. Distinguish application problems from incorrect targets, missing waits, or session state, then report the shortest reliable reproduction steps with only the evidence needed to support the finding.
Build the user interface for a holaOS app whose data resources are already connected through the SDK. Choose a feed, table, kanban board, form, or calendar layout using shared components and workspace styling.
Package workspace skills and their required service integrations into one named, installable capability. Create a manifest that references existing skills, install the capability, and report which integrations still need to be connected.