Neta Elementum Skill

Through the "Elementum Alchemy" workflow, forge any visual concept into a reusable VToken (Virtual Token, TCP/Elementum). Can be referenced in make_image via /ElementName after creation.

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

Command Usage

Create Elementum

Full Alchemy Flow (Recommended)

Follow the four-stage workflow: "Concept Confirmation → Visual Preview → Refinement → Confirmation".

📖 Alchemy Guide - Complete alchemy workflow and best practices

npx -y @talesofai/neta-skills@latest create_elementum \
  --name "RE4 Village" \
  --artifact_uuid "artifacts[0].uuid from make_image response" \
  --prompt "Resident Evil 4 style European medieval village, dilapidated stone houses, burning bonfire, thick fog, dead trees, horror atmosphere, realistic style" \
  --description "This element represents the iconic abandoned European village from Resident Evil 4. Use with night, character descriptions, horror atmosphere. Reference image recreates the original game village style." \
  --accessibility "PUBLIC"

Update Elementum

Targeted Modifications (Only pass fields you want to change)

📖 Update Guide - Update scenarios and workflow

# Update representative image after regenerating
npx -y @talesofai/neta-skills@latest update_elementum \
  --tcp_uuid "element's tcp_uuid" \
  --artifact_uuid "new artifacts[0].uuid from make_image" \
  --prompt "updated image generation instruction"

# Only update Agent usage guide
npx -y @talesofai/neta-skills@latest update_elementum \
  --tcp_uuid "element's tcp_uuid" \
  --description "updated usage guide"

Query Existing Elementa

# List my elementa (created by current user)
npx -y @talesofai/neta-skills@latest list_my_elementum
npx -y @talesofai/neta-skills@latest list_my_elementum --keyword "village" --page_size 10

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

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

Reference Documentation

Scenario	Document
⚗️ Elementum Alchemy Guide	elementum-alchemy.md
🔧 Elementum Update Guide	elementum-update.md
📋 Field Reference Manual	elementum-field-guide.md

What Elementum Can Represent

Elementum encapsulates a visual concept, with wide applicability:

Category	Examples
Scene/Environment	Abandoned village, cyberpunk street, starry desert
Props/Items	Ancient magic book, future weapon, holy grail
Clothing/Style	Hanfu, cyberpunk armor, Lolita dress
Poses/Actions	Battle stance, looking back, leap action
Atmosphere/Lighting	Afternoon sunlight, cyber neon, mysterious shadow
Art Styles	Ink wash, pixel art, comic line art
Memes/Expressions	"This is destiny" meme, Star Wars girl

Usage Recommendations

1. Preview before forging - Use make_image to generate element representative images, confirm satisfaction before calling create_elementum; artifact_uuid is the artifacts[0].uuid from the representative image
2. prompt for image models - prompt is the direct image generation instruction passed to make_image, should be clear, composable, concise and precise; after writing, it should be pasteable directly into make_image --prompt
3. description for Agents - description tells Agents what this element is, how to use it, and any注意事项; recommended format: "This element represents [concept], use by [method], reference image shows [description]"
4. ref_image for style anchoring - If there's a specific reference image (e.g., game screenshot, reference scene), pass ref_image_uuid to let image models anchor the visual style