neta-elementum

Neta Elementum Skill

Through the "Elementum Alchemy" workflow, mint any visual concept into a reusable VToken (virtual token, TCP/Elementum). After creation, it can be used in make_image via /元素名 reference.

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

Command Usage

Create Element

Complete Alchemy Workflow (Recommended)

Follow the four-stage process: "Concept Confirmation → Visual Preview → Refinement and Encapsulation → Mint Confirmation".

📖 Alchemy Guide - Complete alchemy workflow and best practices

npx -y @talesofai/neta-skills@latest create_elementum \
  --name "RE4村庄" \
  --artifact_uuid "make_image返回的artifacts[0].uuid" \
  --prompt "生化危机4风格欧洲中世纪村庄，破旧石屋，燃烧篝火，浓雾弥漫，枯木，恐怖压抑氛围，写实风格" \
  --description "此元素表示生化危机4标志性的废弃欧洲村庄场景。使用时搭配夜晚、角色人物、恐怖氛围等描述词，可与角色引用同用。参考图为原版游戏村庄截图风格的复现。" \
  --accessibility "PUBLIC"

Update Element

Targeted modification (only pass the fields that need to be changed)

📖 Update Guide - Update scenarios and workflow

# 重新生图后更换代表图
npx -y @talesofai/neta-skills@latest update_elementum \
  --tcp_uuid "元素的tcp_uuid" \
  --artifact_uuid "新make_image返回的artifacts[0].uuid" \
  --prompt "更新后的生图指令"

# 只更新 Agent 使用说明
npx -y @talesofai/neta-skills@latest update_elementum \
  --tcp_uuid "元素的tcp_uuid" \
  --description "更新后的使用说明"

Query Existing Elements

# 列出我的元素（当前用户创建的元素）
npx -y @talesofai/neta-skills@latest list_my_elementum
npx -y @talesofai/neta-skills@latest list_my_elementum --keyword "村庄" --page_size 10

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

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

Reference Documentation

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

What Elementum Can Represent

Elementum is an encapsulation of avisual concept, with a very broad scope of application:

Category	Example
Scene/Environment	Abandoned village, cyberpunk street, starry desert
Prop/Item	Ancient magic book, futuristic weapon, holy grail
Clothing/Style	Hanfu, cyberpunk battle armor, Lolita dress
Pose/Action	Combat stance, looking back, leaping action
Atmosphere/Lighting	Afternoon sunlight, cyber neon, mysterious shadows
Art Style	Ink wash style, pixel style, comic line art
Meme/Emoji Pack	"This is destiny" meme, Star Wars girl

Usage Recommendations

Preview before minting - Use make_image to generate a representative image for the element. After confirming the visual is satisfactory, call create_elementum；artifact_uuid , which is the artifacts[0].uuid
prompt is for the image model to read - prompt is the image generation instruction passed directly to make_image . The language should be clear, composable, concise, and precise; after writing it, it should be possible to paste it directly into make_image --prompt for use
description is for the Agent to read - description tells the Agent what this element is, how it is suitable to be used, and what precautions there are; suggested format: "This element represents [concept], when using it [method], the reference image shows [explanation]"
ref_image is used for style anchoring - If there is a specific reference image (such as a game screenshot or reference frame), pass ref_image_uuid to let the image model anchor the visual style