neta-character

Neta Character Skill

Guide users from inspiration to minting, completing the creation and management of their exclusive character VToken (Virtual Token, TCP/OC). After the character is created, it can be referenced in make_image via @角色名 .

This skill needs to be used together with the neta-creative skill make_image for visual previews.

Command Usage

Create Character

Complete creation workflow (recommended)

Follow the three-stage workflow of "visual preview → character documentation → confirm creation".

📖 Creation Guide - Complete creative workflow and best practices

npx -y @talesofai/neta-skills@latest create_character \
  --name "Ada Wong" \
  --avatar_artifact_uuid "make_image返回的artifacts[0].uuid" \
  --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 "女" \
  --age "28" \
  --occupation "间谍" \
  --persona "神秘冷静，目的不明，游走于各方势力之间" \
  --interests "情报收集，格斗，精密机械" \
  --description "艾达·王，黑发红裙的神秘间谍，真实目的无人知晓。外貌冷峻优雅，实为天才特工，多次与生化危机事件交织，却始终保持独立立场。" \
  --accessibility "PUBLIC"

Update Character

Make targeted modifications (only pass the fields that need to be changed)

📖 Update Guide - Update scenarios and workflow

# 重新生图后更换视觉外观
npx -y @talesofai/neta-skills@latest update_character \
  --tcp_uuid "角色的tcp_uuid" \
  --avatar_artifact_uuid "新make_image返回的artifacts[0].uuid" \
  --prompt "新的视觉特征描述"

# 只更新背景故事
npx -y @talesofai/neta-skills@latest update_character \
  --tcp_uuid "角色的tcp_uuid" \
  --description "更新后的角色背景故事"

# 更新多个字段
npx -y @talesofai/neta-skills@latest update_character \
  --tcp_uuid "角色的tcp_uuid" \
  --persona "新的性格描述" \
  --interests "新的兴趣" \
  --occupation "新的职业"

Query Existing Characters

# 列出我的角色（当前用户创建的角色）
npx -y @talesofai/neta-skills@latest list_my_characters
npx -y @talesofai/neta-skills@latest list_my_characters --keyword "艾达" --page_size 10

# 搜索角色（全站关键词匹配）
npx -y @talesofai/neta-skills@latest search_character_or_elementum --keywords "角色名" --parent_type "character"

# 获取角色完整详情（含 tcp_uuid）
npx -y @talesofai/neta-skills@latest request_character_or_elementum --name "角色名"

Reference Documentation

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

Usage Recommendations

Preview before creating - Use make_image to generate a character preview image; after confirming the visuals are satisfactory, call create_character；avatar_artifact_uuid is the artifacts[0].uuid
Preview uses plain text only - make_image During the preview stage, use plain natural language to describe appearance; do not add @角色名(because the character has not been created yet)
trigger must be in English - trigger It is the recognition anchor for image models and language models; a Chinese trigger will significantly reduce recognition rates; it should include gender words, character name, prominent appearance features, and the IP series it belongs to
prompt only writes visuals - prompt Only describe physiological features, clothing, and special marks; do not write personality, story, or background
description is for humans and Agents to read - description Should include an appearance summary + character backstory, so that the Agent can understand the character's context in subsequent creations