talesofai/neta-elementum

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