> ## Documentation Index
> Fetch the complete documentation index at: https://slackhive.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Import & Export

> Export an agent's configuration as a JSON file and import it into any other agent.

## 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:

```json theme={null}
{
  "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

<Note>
  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.
</Note>

***

## Common use cases

| Use case                     | How                                                                                     |
| ---------------------------- | --------------------------------------------------------------------------------------- |
| **Clone an agent**           | Export agent A → create agent B → import into B                                         |
| **Promote staging → prod**   | Export from a test agent, import into the live one                                      |
| **Backup before a big edit** | Export before making large changes to an agent's instructions                           |
| **Share agent templates**    | Export and send the JSON to a teammate to import                                        |
| **Roll back instructions**   | Use [Version History](/features/history) for full snapshots, or re-import an old export |

***

## Next steps

<CardGroup cols={2}>
  <Card title="Version History" icon="clock-rotate-left" href="/features/history">
    Auto-snapshots on every save - browse diffs and restore any version.
  </Card>

  <Card title="Creating Agents" icon="robot" href="/agents/creating-agents">
    Set up a new agent to import a config into.
  </Card>
</CardGroup>