Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mira-app.dev/llms.txt

Use this file to discover all available pages before exploring further.

Skills are stored locally in mira.db and can be exported as self-contained JSON files for sharing, backup, or use across multiple MIRA installations.

​
Exporting a Skill

1

Open Skills Studio

Press ⌘2 to open the Skills view.
2

Select the skill to export

Click the skill in the list, then click ⋮ → Export.
3

Save the file

Choose a location and save as [skill-name].json. The file is self-contained and contains all configuration — no secrets are included.

​
Importing a Skill

1

Open Skills Studio

Press ⌘2.
2

Click Import

Click the Import button at the top of the Skills list.
3

Select the JSON file

Pick the .json file exported from another MIRA instance. The skill appears in the list immediately.

​
Skill JSON format

Exported skills are human-readable JSON. All fields are required unless marked optional. 
{
  "name": "My Custom Skill",
  "description": "Short description shown in the skill picker.",
  "category": "Custom",
  "icon": "🔬",
  "color": "#10b981",
  "instructions": "## Active Skill Mode: My Custom Skill\n\nDescribe the persona, expertise, and behaviour rules here.",
  "modelOverrides": {
    "temperature": 0.3,
    "maxIterations": 20,
    "maxTokens": 8192,
    "temperatureEnabled": true,
    "maxIterationsEnabled": true,
    "maxTokensEnabled": false
  },
  "mcpAllowlist": [],
  "documentTemplates": [],
  "scope": "session",
  "isEnabled": true,
  "isBuiltin": false
}

​
Field reference

FieldTypeRequiredNotes
namestring✅Displayed in the skill picker and session header
descriptionstring✅One-line summary shown below the name
categorystring✅See valid values below
iconstring✅Any single emoji character
colorstring✅Hex colour for the skill card accent (#rrggbb)
instructionsstring✅Full system-level instructions injected at session start. Supports Markdown.
modelOverridesobject✅Per-skill model parameter overrides (see below)
mcpAllowliststring[]✅List of MCP server IDs allowed for this skill. Empty array = all servers allowed.
documentTemplatesstring[]✅Reserved for future use — set to []
scopestring✅"session" or "global"
isEnabledboolean✅Whether the skill is selectable. Set to true for usable skills.
isBuiltinboolean✅Always false for custom/imported skills
category valid values: "Research" · "Coding" · "Domain Expert" · "Creative" · "Deterministic" · "Custom" scope valid values:
  • "session" — skill is applied only to the current session and is not persisted across sessions
  • "global" — skill is automatically available across all sessions
modelOverrides fields:
FieldTypeNotes
temperaturenumber0.0 – 2.0. Lower = more deterministic.
maxIterationsnumberMax reasoning iterations (RLM engine). Recommended: 10–30.
maxTokensnumberMax tokens per response.
temperatureEnabledbooleanIf false, the provider default is used instead.
maxIterationsEnabledbooleanIf false, the engine default is used instead.
maxTokensEnabledbooleanIf false, the provider default is used instead.
Edit the exported JSON in any text editor, change the name and instructions, set "isBuiltin": false, then import — you have a new skill in seconds.

​
Version history

Every time you save a skill, MIRA creates a new version automatically. To view and restore previous versions:
  1. Open the skill in the editor
  2. Click ⋮ → Version History
  3. A panel shows all saved versions with timestamps
  4. Click any version to preview it
  5. Click Restore to make that version current
Restoring creates a new version — the current version is not overwritten, it becomes the previous entry in the history.

​
Sharing skills with your team

Skills can be committed to a shared repository as JSON files and distributed to teammates. Each team member imports the file into their own MIRA installation. Updates require re-exporting and re-importing — there is no live sync.