talesofai/neta-character

Neta Character Skill

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.

This skill requires the neta-creative skill to use make_image for visual previews.

Command Usage

Create Character

Full Creation Flow (Recommended)

Follow the three-stage workflow: "Visual Preview → Character Documentation → Confirmation".

📖 Creation Guide - Complete creative workflow and best practices

npx -y @talesofai/neta-skills@latest create_character \
  --name "Ada Wong" \
  --avatar_artifact_uuid "artifacts[0].uuid from make_image response" \
  --prompt "long black hair, red qipao dress, blue eyes, gun holster on thigh, slender figure" \
  --trigger "1girl, Ada Wong, black hair, red dress, spy, elegant, resident evil series" \
  --gender "female" \
  --age "28" \
  --occupation "spy" \
  --persona "Mysterious and calm, purpose unknown, moves between factions" \
  --interests "intelligence gathering, combat, precision machinery" \
  --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." \
  --accessibility "PUBLIC"

Update Character

Targeted Modifications (Only pass fields you want to change)

📖 Update Guide - Update scenarios and workflow

# Update visual appearance after regenerating image
npx -y @talesofai/neta-skills@latest update_character \
  --tcp_uuid "character's tcp_uuid" \
  --avatar_artifact_uuid "new artifacts[0].uuid from make_image" \
  --prompt "updated visual feature description"

# Only update backstory
npx -y @talesofai/neta-skills@latest update_character \
  --tcp_uuid "character's tcp_uuid" \
  --description "updated character backstory"

# Update multiple fields
npx -y @talesofai/neta-skills@latest update_character \
  --tcp_uuid "character's tcp_uuid" \
  --persona "new personality description" \
  --interests "new interests" \
  --occupation "new occupation"

Query Existing Characters

# List my characters (created by current user)
npx -y @talesofai/neta-skills@latest list_my_characters
npx -y @talesofai/neta-skills@latest list_my_characters --keyword "Ada" --page_size 10

# Search characters (global search, keyword matching)
npx -y @talesofai/neta-skills@latest search_character_or_elementum --keywords "character name" --parent_type "character"

# Get full character details (including tcp_uuid)
npx -y @talesofai/neta-skills@latest request_character_or_elementum --name "character name"

Reference Documentation

| Scenario | Document | |----------|----------| | ✨ Character Creation Guide | character-creation.md | | 🔧 Character Update Guide | character-update.md | | 📋 Field Reference Manual | character-field-guide.md |

Usage Recommendations

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
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)
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
4. prompt is visual only - prompt only describes physical features, clothing, distinctive marks; exclude personality, story, background
5. description is for humans and Agents - description should include appearance summary + backstory, for Agents to understand character context in subsequent creations