$npx -y skills add talesofai/neta-skills --skill neta-characterNeta Character Forging Skill - Guides users through creating or updating anime/cultural IP/original character (OC) VTokens (Virtual Tokens, TCP). Includes visual preview, character documentation, backstory confirmation, and complete creative workflow. Use this skill when users wa
| 1 | # Neta Character Skill |
| 2 | |
| 3 | Guide users from inspiration to forging, completing the creation and management of exclusive character VTokens (Virtual Tokens, TCP/OC). Characters can be referenced in `make_image` via `@CharacterName` after creation. |
| 4 | |
| 5 | > This skill requires the **neta-creative** skill to use `make_image` for visual previews. |
| 6 | |
| 7 | ## Command Usage |
| 8 | |
| 9 | ### Create Character |
| 10 | |
| 11 | **Full Creation Flow (Recommended)** |
| 12 | |
| 13 | Follow the three-stage workflow: "Visual Preview → Character Documentation → Confirmation". |
| 14 | |
| 15 | 📖 [Creation Guide](./references/character-creation.md) - Complete creative workflow and best practices |
| 16 | |
| 17 | ```bash |
| 18 | npx -y @talesofai/neta-skills@latest create_character \ |
| 19 | --name "Ada Wong" \ |
| 20 | --avatar_artifact_uuid "artifacts[0].uuid from make_image response" \ |
| 21 | --prompt "long black hair, red qipao dress, blue eyes, gun holster on thigh, slender figure" \ |
| 22 | --trigger "1girl, Ada Wong, black hair, red dress, spy, elegant, resident evil series" \ |
| 23 | --gender "female" \ |
| 24 | --age "28" \ |
| 25 | --occupation "spy" \ |
| 26 | --persona "Mysterious and calm, purpose unknown, moves between factions" \ |
| 27 | --interests "intelligence gathering, combat, precision machinery" \ |
| 28 | --description "Ada Wong, a mysterious spy with black hair and red dress. Her true identity is unknown, and she has repeatedly appeared as a middleman in Resident Evil incidents, maintaining an independent stance." \ |
| 29 | --accessibility "PUBLIC" |
| 30 | ``` |
| 31 | |
| 32 | ### Update Character |
| 33 | |
| 34 | **Targeted Modifications (Only pass fields you want to change)** |
| 35 | |
| 36 | 📖 [Update Guide](./references/character-update.md) - Update scenarios and workflow |
| 37 | |
| 38 | ```bash |
| 39 | # Update visual appearance after regenerating image |
| 40 | npx -y @talesofai/neta-skills@latest update_character \ |
| 41 | --tcp_uuid "character's tcp_uuid" \ |
| 42 | --avatar_artifact_uuid "new artifacts[0].uuid from make_image" \ |
| 43 | --prompt "updated visual feature description" |
| 44 | |
| 45 | # Only update backstory |
| 46 | npx -y @talesofai/neta-skills@latest update_character \ |
| 47 | --tcp_uuid "character's tcp_uuid" \ |
| 48 | --description "updated character backstory" |
| 49 | |
| 50 | # Update multiple fields |
| 51 | npx -y @talesofai/neta-skills@latest update_character \ |
| 52 | --tcp_uuid "character's tcp_uuid" \ |
| 53 | --persona "new personality description" \ |
| 54 | --interests "new interests" \ |
| 55 | --occupation "new occupation" |
| 56 | ``` |
| 57 | |
| 58 | ### Query Existing Characters |
| 59 | |
| 60 | ```bash |
| 61 | # List my characters (created by current user) |
| 62 | npx -y @talesofai/neta-skills@latest list_my_characters |
| 63 | npx -y @talesofai/neta-skills@latest list_my_characters --keyword "Ada" --page_size 10 |
| 64 | |
| 65 | # Search characters (global search, keyword matching) |
| 66 | npx -y @talesofai/neta-skills@latest search_character_or_elementum --keywords "character name" --parent_type "character" |
| 67 | |
| 68 | # Get full character details (including tcp_uuid) |
| 69 | npx -y @talesofai/neta-skills@latest request_character_or_elementum --name "character name" |
| 70 | ``` |
| 71 | |
| 72 | ## Reference Documentation |
| 73 | |
| 74 | | Scenario | Document | |
| 75 | |----------|----------| |
| 76 | | ✨ Character Creation Guide | [character-creation.md](./references/character-creation.md) | |
| 77 | | 🔧 Character Update Guide | [character-update.md](./references/character-update.md) | |
| 78 | | 📋 Field Reference Manual | [character-field-guide.md](./references/character-field-guide.md) | |
| 79 | |
| 80 | ## Usage Recommendations |
| 81 | |
| 82 | 1. **Preview before creating** - Use `make_image` to generate character preview images, confirm satisfaction before calling `create_character`; `avatar_artifact_uuid` is the `artifacts[0].uuid` from the preview |
| 83 | 2. **Use plain text for previews** - In the `make_image` preview stage, use plain natural language descriptions without `@CharacterName` (since the character doesn't exist yet) |
| 84 | 3. **trigger must be English** - `trigger` is the recognition anchor for image and language models; Chinese triggers significantly reduce recognition accuracy; should include gender terms, character name, prominent visual features, IP series |
| 85 | 4. **prompt is visual only** - `prompt` only describes physical features, clothing, distinctive marks; exclude personality, story, background |
| 86 | 5. **description is for humans and Agents** - `description` should include appearance summary + backstory, for Agents to understand character context in subsequent creations |