$npx -y skills add talesofai/neta-skills --skill neta-elementumNeta Elementum Alchemy Skill - Guides users through creating or updating style element (Elementum) VTokens (Virtual Tokens, TCP). Elementum encapsulates a visual concept (scene, prop, clothing, weapon, pose, atmosphere, meme, etc.) and can be referenced in make_image via /Element
| 1 | # Neta Elementum Skill |
| 2 | |
| 3 | 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. |
| 4 | |
| 5 | > This skill requires the **neta-creative** skill to use `make_image` for visual previews. |
| 6 | |
| 7 | ## Command Usage |
| 8 | |
| 9 | ### Create Elementum |
| 10 | |
| 11 | **Full Alchemy Flow (Recommended)** |
| 12 | |
| 13 | Follow the four-stage workflow: "Concept Confirmation → Visual Preview → Refinement → Confirmation". |
| 14 | |
| 15 | 📖 [Alchemy Guide](./references/elementum-alchemy.md) - Complete alchemy workflow and best practices |
| 16 | |
| 17 | ```bash |
| 18 | npx -y @talesofai/neta-skills@latest create_elementum \ |
| 19 | --name "RE4 Village" \ |
| 20 | --artifact_uuid "artifacts[0].uuid from make_image response" \ |
| 21 | --prompt "Resident Evil 4 style European medieval village, dilapidated stone houses, burning bonfire, thick fog, dead trees, horror atmosphere, realistic style" \ |
| 22 | --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." \ |
| 23 | --accessibility "PUBLIC" |
| 24 | ``` |
| 25 | |
| 26 | ### Update Elementum |
| 27 | |
| 28 | **Targeted Modifications (Only pass fields you want to change)** |
| 29 | |
| 30 | 📖 [Update Guide](./references/elementum-update.md) - Update scenarios and workflow |
| 31 | |
| 32 | ```bash |
| 33 | # Update representative image after regenerating |
| 34 | npx -y @talesofai/neta-skills@latest update_elementum \ |
| 35 | --tcp_uuid "element's tcp_uuid" \ |
| 36 | --artifact_uuid "new artifacts[0].uuid from make_image" \ |
| 37 | --prompt "updated image generation instruction" |
| 38 | |
| 39 | # Only update Agent usage guide |
| 40 | npx -y @talesofai/neta-skills@latest update_elementum \ |
| 41 | --tcp_uuid "element's tcp_uuid" \ |
| 42 | --description "updated usage guide" |
| 43 | ``` |
| 44 | |
| 45 | ### Query Existing Elementa |
| 46 | |
| 47 | ```bash |
| 48 | # List my elementa (created by current user) |
| 49 | npx -y @talesofai/neta-skills@latest list_my_elementum |
| 50 | npx -y @talesofai/neta-skills@latest list_my_elementum --keyword "village" --page_size 10 |
| 51 | |
| 52 | # Search elements (global search, keyword matching) |
| 53 | npx -y @talesofai/neta-skills@latest search_character_or_elementum --keywords "element name" --parent_type "elementum" |
| 54 | |
| 55 | # Get full element details (including tcp_uuid) |
| 56 | npx -y @talesofai/neta-skills@latest request_character_or_elementum --name "element name" |
| 57 | ``` |
| 58 | |
| 59 | ## Reference Documentation |
| 60 | |
| 61 | | Scenario | Document | |
| 62 | |----------|----------| |
| 63 | | ⚗️ Elementum Alchemy Guide | [elementum-alchemy.md](./references/elementum-alchemy.md) | |
| 64 | | 🔧 Elementum Update Guide | [elementum-update.md](./references/elementum-update.md) | |
| 65 | | 📋 Field Reference Manual | [elementum-field-guide.md](./references/elementum-field-guide.md) | |
| 66 | |
| 67 | ## What Elementum Can Represent |
| 68 | |
| 69 | Elementum encapsulates a **visual concept**, with wide applicability: |
| 70 | |
| 71 | | Category | Examples | |
| 72 | |----------|----------| |
| 73 | | Scene/Environment | Abandoned village, cyberpunk street, starry desert | |
| 74 | | Props/Items | Ancient magic book, future weapon, holy grail | |
| 75 | | Clothing/Style | Hanfu, cyberpunk armor, Lolita dress | |
| 76 | | Poses/Actions | Battle stance, looking back, leap action | |
| 77 | | Atmosphere/Lighting | Afternoon sunlight, cyber neon, mysterious shadow | |
| 78 | | Art Styles | Ink wash, pixel art, comic line art | |
| 79 | | Memes/Expressions | "This is destiny" meme, Star Wars girl | |
| 80 | |
| 81 | ## Usage Recommendations |
| 82 | |
| 83 | 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 |
| 84 | 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` |
| 85 | 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]" |
| 86 | 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 |