Skip to main content

​
What gets exported

The export captures the full agent configuration:
  • Persona - the starter persona slug (if one was picked in the Profile step)
  • Description - the one-line description shown to boss agents
  • System prompt - identity, instructions, and behavior rules
  • Skills - all Markdown skill files (category, filename, content, sort order)
Slack credentials, memories, wiki content, and scheduled jobs are not included. This keeps exports portable - you can import a config into any agent without overwriting live credentials, ingested wiki, or accumulated memory.

​
Exporting an agent

  1. Open the agent in the dashboard
  2. Click the Download icon in the top-right of the agent page
  3. A JSON file named {agent-slug}-export.json downloads immediately
The file looks like: 
{
  "persona": "data-analyst",
  "description": "Answers questions about product metrics and builds ad-hoc SQL.",
  "claudeMd": "# DataBot\n\nYou are a data analyst...",
  "skills": [
    {
      "category": "sql",
      "filename": "sql-rules.md",
      "content": "## SQL Rules\n...",
      "sortOrder": 0
    }
  ]
}

​
Importing a config

Import applies an exported config to an existing agent - it overwrites that agent’s system prompt and upserts its skills. Persona and description are applied if present in the export.
  1. Open the target agent in the dashboard
  2. Click the Upload icon in the top-right
  3. Select the .json export file
  4. A confirmation modal shows what will be applied:
    • Persona and description (if present)
    • The new system prompt content
    • How many skills will be upserted
  5. Click Apply Import to confirm
Import overwrites the agent’s current system prompt. Skills are upserted - existing skills with the same name are updated, new ones are added, and skills not in the import are left untouched.

​
Common use cases

Use caseHow
Clone an agentExport agent A → create agent B → import into B
Promote staging → prodExport from a test agent, import into the live one
Backup before a big editExport before making large changes to an agent’s instructions
Share agent templatesExport and send the JSON to a teammate to import
Roll back instructionsUse Version History for full snapshots, or re-import an old export

​
Next steps

Version History

Auto-snapshots on every save - browse diffs and restore any version.

Creating Agents

Set up a new agent to import a config into.