Extend Bolt

Skills and agents.

Teach the AI in Bolt a prompt or a tool, or add an agent of your own. Personal, if your organization allows it.

Skills.

Settings → Skills. A skill you make is yours. Your organization can turn off adding your own skills, and on some plans skills are not available.

FormatWhat it doesTier
promptInstructions added to the conversation when the skill is used.1
toolA tool the AI can call. It makes one HTTP request to an endpoint you describe.3
agent_taskA scoped agent run with its own tools and limits.3
FieldMeaning
name, descriptionWhat it is.
formatprompt, tool or agent_task.
contentThe prompt text, or the tool definition in YAML.
tags, trigger_wordFind it and start it by a word.
A tool skill (content)
name: ticket_status
description: Look up a support ticket by number
parameters:
  type: object
  properties:
    id: { type: string, description: "Ticket number" }
  required: [id]
instructions: Use when the user asks about a ticket number.
endpoint:
  url: "https://support.example.com/api/tickets/lookup"
  method: POST
  body_template: '{"id": "{{id}}"}'

The URL is fixed; the AI's arguments go into body_template as {{name}}.

Agents.

Settings → Agents. Use one by typing @ and its name in a chat, or with one of its trigger words. Your organization can turn off adding your own agents.

FieldMeaning
name, description, instructionsWho the agent is and how it works.
backendWhere it runs: Bolt's own loop, or a remote endpoint (OpenAI-compatible, custom HTTP, or A2A).
tool_allowlist, tool_blocklist, mcp_allowlistWhich tools and MCP servers it may use.
max_iterations, reasoning_strategyHow long it may work.
triggersKeywords that send a request to it.
background_capable, icon, tagsRun in the background; display.

An agent with tools is tier 3: it can act through every tool it is allowed. Keep its tool list short.

Share them as a Boltpack.

  • Export: on the Skills or Agents page, export your own skills or agents. Bolt writes a signed .boltpack.
  • Secrets stay behind: a remote agent's API key or sign-in is removed from the export. The person who imports it adds their own.
  • Import: Settings → Agents → Import takes a Boltpack of skills and agents. Bolt checks the signature and shows what it holds before you confirm.
  • Always yours: an imported agent is your personal agent, even if the pack says otherwise. Your organization's rules for adding skills and agents still apply.