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
- 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:/mcpto sign in if the Mage plugin is installed, otherwiseclaude mcp add --transport http mage https://mcp.mage.space/mcp; others: https://www.mage.space/mcp), then wait. - Images are links.
create_characterandcreate_referencetake an https URL of a JPEG or PNG, a data URL, or an upload URL fromcreate_upload. Files attached to the chat never reach Mage: ask for a direct link, or upload from disk when you can run commands. - Consent. Only save a real person's likeness with that person's consent. Never build a character to impersonate someone.
UX rules
- Be concise. Report "Saved @nova" with the name, not ids or JSON.
- Reply in the user's language.
- Ask only for what's missing: a name and one portrait. Derive the handle from the name unless the user picks one.
- Saving is free; generating costs Gems. Quote generations as usual and wait for a yes before a batch or a video.
- Check
list_charactersbefore creating, so you don't duplicate one that exists.