mage-characters

Installation
SKILL.md

Mage Characters

Save someone or something once, then keep it consistent everywhere. A Mage character is a portrait with an optional voice; a reference is an outfit, pose, location, object, or voice clip. Both are private to the account and are used by writing @handle in any prompt.

Before you start

  1. Mage tools. This skill uses list_characters, create_character, delete_character, list_references, create_reference, delete_reference, and the generation tools (get_model, estimate_cost, generate, get_request). If they are missing, ask the user to connect Mage (Claude: Customize → Connectors → Add custom connector, https://mcp.mage.space/mcp; Claude Code: /mcp to sign in if the Mage plugin is installed, otherwise claude mcp add --transport http mage https://mcp.mage.space/mcp; others: https://www.mage.space/mcp), then wait.
  2. Images are links. create_character and create_reference take an https URL of a JPEG or PNG, a data URL, or an upload URL from create_upload. Files attached to the chat never reach Mage: ask for a direct link, or upload from disk when you can run commands.
  3. Consent. Only save a real person's likeness with that person's consent. Never build a character to impersonate someone.

UX rules

  1. Be concise. Report "Saved @nova" with the name, not ids or JSON.
  2. Reply in the user's language.
  3. Ask only for what's missing: a name and one portrait. Derive the handle from the name unless the user picks one.
  4. Saving is free; generating costs Gems. Quote generations as usual and wait for a yes before a batch or a video.
  5. Check list_characters before creating, so you don't duplicate one that exists.

Save a character

Installs
59
GitHub Stars
4
First Seen
Oct 2, 2026