@talesofai/neta-skills 0.6.0

package/skills/neta-community/SKILL.md

@@ -0,0 +1,123 @@
+---
+name: neta-community
+description: Neta API community skill — browse interactive feeds, view collection details, like and interact with content, and browse content by tags and characters in a community context. Use this skill when the user wants to “see what people are making”, “scroll the feed”, or “interact with works”. Do not use it for taxonomy/keyword‑level research (handled by neta-suggest) or for generating images/videos/songs (handled by neta-creative).
+---
+
+# Neta Community Skill
+
+Used to interact with the Neta API for community feed browsing, interactions, and tag‑based queries.
+
+## Instructions
+
+1. For tasks like **“see what’s in the community”**, **“scroll the feed”**, or **“like or interact with works”**, use this skill as follows:
+2. Recommended flow:
+   - Use the feed command to fetch a list of recommended content.
+   - Use the collection‑detail command to inspect a specific work.
+   - Perform likes and other interactions on works as needed.
+3. If the user needs **systematic research or complex filtering by categories/keywords**, switch to `neta-suggest`.
+4. If the user wants to **create new content** (images/videos/songs/MVs), switch to `neta-creative`.
+
+## Prerequisites
+
+Make sure the `NETA_TOKEN` environment variable is set.
+
+Install the latest version of the Neta CLI:
+
+```bash
+neta-cli --version
+0.6.0
+```
+
+```bash
+npm i @talesofai/neta-cli@latest -g
+```
+
+```bash
+pnpm add -g @talesofai/neta-cli@latest
+```
+
+## Commands
+
+### Feed
+
+**Get interactive feed**
+
+```bash
+neta-cli request_interactive_feed --page_index 0 --page_size 3
+```
+
+**Get collection details**
+
+```bash
+neta-cli read_collection --uuid "collection-uuid"
+```
+
+📖 [Detailed guide](./references/interactive-feed.md)
+
+### Community interactions
+
+```bash
+neta-cli like_collection --uuid "target collection UUID"
+```
+
+📖 [Detailed guide](./references/social-interactive.md)
+
+### Tag queries
+
+**Get tag info**
+
+```bash
+neta-cli get_hashtag_info --hashtag "tag_name"
+```
+
+📖 [Detailed guide](./references/hashtag-research.md) — research flow and analysis methods.
+
+**Get characters under a tag**
+
+```bash
+neta-cli get_hashtag_characters --hashtag "tag_name" --sort_by "hot"
+```
+
+**Get collections under a tag**
+
+```bash
+neta-cli get_hashtag_collections --hashtag "tag_name"
+```
+
+### Character queries
+
+**Search characters**
+
+```bash
+neta-cli search_character_or_elementum --keywords "keywords" --parent_type "character" --sort_scheme "exact"
+``]
+
+📖 [Detailed guide](./references/character-search.md) — search strategies and parameter choices.
+
+**Get character details**
+
+```bash
+neta-cli request_character_or_elementum --name "character_name"
+```
+
+**Query by UUID**
+
+```bash
+neta-cli request_character_or_elementum --uuid "uuid"
+```
+
+## Reference docs
+
+| Scenario                 | Doc                                               |
+|--------------------------|---------------------------------------------------|
+| 🎮 Interactive feed      | [interactive-feed.md](./references/interactive-feed.md) |
+| 💬 Community interactions| [social-interactive.md](./references/social-interactive.md) |
+| 🏷️ Tag research         | [hashtag-research.md](./references/hashtag-research.md)   |
+| 👤 Character queries     | [character-search.md](./references/character-search.md)   |
+
+## Usage tips
+
+1. **Browse before interacting**: use the feed first to understand the overall content landscape, then interact (like, etc.) with the works that matter.
+2. **Leverage tags**: combining tag queries with character searches quickly focuses on the most relevant set of works.
+3. **Combine with research/creation skills**: use `neta-suggest` for deeper tag/category research, and `neta-creative` when you want to create derivative works based on community content.
+

package/skills/neta-creative/SKILL.md

@@ -0,0 +1,118 @@
+---
+name: neta-creative
+description: Neta API creative skill — generate images, videos, songs, and MVs, and deconstruct creative ideas from existing works. Use this skill when the user wants to create or edit images/videos/songs/MVs, or create based on character settings and existing works. Do not use it for feed browsing or tag/category research (those are handled by neta-community and neta-suggest).
+---
+
+# Neta Creative Skill
+
+Used to interact with the Neta API for multimedia content creation and creation‑related character queries.
+
+## Instructions
+
+1. For tasks that **create or edit concrete assets** (images, videos, songs, MVs, background removal), follow this flow:
+   - Before creation, use **character queries** to fetch canonical character settings, then generate images/videos/songs based on them.
+   - To reverse‑engineer creative ideas from an existing work, call `read_collection` and combine the result with the guidance in the reference docs.
+2. If, during creation, you discover that the real need is more like “browse recommendations / casually explore / research topics”, combine this skill with `neta-community` or `neta-suggest` instead of overloading this skill.
+
+## Prerequisites
+
+Make sure the `NETA_TOKEN` environment variable is set.
+
+Also ensure the latest Neta CLI is installed:
+
+```bash
+neta-cli --version
+0.6.0
+```
+
+```bash
+npm i @talesofai/neta-cli@latest -g
+```
+
+```bash
+pnpm add -g @talesofai/neta-cli@latest
+```
+
+## Commands
+
+### Content creation
+
+**Generate image**
+
+```bash
+neta-cli make_image --prompt "@character_name, /elementum_name, ref_img-uuid, description1, description2" --aspect "3:4"
+```
+
+📖 [Detailed guide](./references/image-generation.md) — prompt structure, aspect ratio choices, examples.
+
+**Generate video**
+
+```bash
+neta-cli make_video --image_source "image URL" --prompt "action description" --model "model_s"
+```
+
+📖 [Detailed guide](./references/video-generation.md) — motion description principles, model selection.
+
+**Generate song**
+
+```bash
+neta-cli make_song --prompt "style description" --lyrics "lyrics content"
+```
+
+📖 [Detailed guide](./references/song-creation.md) — style prompts, lyrics format.
+
+**Create MV**
+
+Combine an audio track and video to create a full MV.
+
+📖 [Detailed guide](./references/song-mv.md) — end‑to‑end workflow.
+
+**Remove background**
+
+```bash
+neta-cli remove_background --input_image "image_url"
+```
+
+### Character queries
+
+**Search characters**
+
+```bash
+neta-cli search_character_or_elementum --keywords "keywords" --parent_type "character" --sort_scheme "exact"
+```
+
+📖 [Detailed guide](./references/character-search.md) — search strategies and parameter choices.
+
+**Get character details**
+
+```bash
+neta-cli request_character_or_elementum --name "character_name"
+```
+
+**Query by UUID**
+
+```bash
+neta-cli request_character_or_elementum --uuid "uuid"
+```
+
+### Creative idea deconstruction
+
+**Derive creative ideas from a work**
+
+```bash
+neta-cli read_collection --uuid "collection-uuid"
+```
+
+📖 [Detailed guide](./references/collection-remix.md)
+
+## Reference docs
+
+| Scenario              | Doc                                      |
+|-----------------------|------------------------------------------|
+| 🎨 Image generation   | [image-generation.md](./references/image-generation.md) |
+| 🎬 Video generation   | [video-generation.md](./references/video-generation.md) |
+| 🎵 Song generation    | [song-creation.md](./references/song-creation.md)       |
+| 🎞️ MV creation       | [song-mv.md](./references/song-mv.md)                   |
+| 👤 Character queries  | [character-search.md](./references/character-search.md) |
+| 🖊️ Creative remixing | [collection-remix.md](./references/collection-remix.md) |
+

package/skills/neta-space/SKILL.md

@@ -0,0 +1,129 @@
+---
+name: neta-space
+description: Neta API space and world‑view browsing skill — browse worldbuilding, sub‑spaces, and playable content by space/hashtag. Use this skill when the user talks about worlds/spaces/universes/scenes, or wants to browse characters and gameplay based on space and activity structure. Do not use it for concrete media creation (handled by neta-creative).
+---
+
+# Neta Space Skill
+
+Used to interact with the Neta API to browse space‑level content.
+
+## Instructions
+
+1. For tasks like **“what spaces/activities exist?”** or **“what is the structure and lore of a given space?”**, organize queries as follows:
+2. Recommended workflow:
+   - List all spaces.
+   - For a chosen space, fetch its details (lore, activities, metrics).
+   - Fetch sub‑spaces and their official/user collections.
+   - If needed, fetch characters and playable content inside the space.
+3. If the user says “now generate an image/video/song for this space”, first collect the relevant space/collection info here, then switch to `neta-creative` for creation.
+
+## Prerequisites
+
+Make sure the `NETA_TOKEN` environment variable is set.
+
+Install the latest version of the Neta CLI:
+
+```bash
+neta-cli --version
+0.6.0
+```
+
+```bash
+npm i @talesofai/neta-cli@latest -g
+```
+
+```bash
+pnpm add -g @talesofai/neta-cli@latest
+```
+
+## Space concepts
+
+> A space is a themed collection of gameplay experiences — a scene where content is produced and consumed.
+
+## Terminology
+
+- **Hashtag**: tag/space. Used to build worlds and organize communities.
+- **Collection**: browseable/remixable/editable content; can also refer to events, scenes, or gameplay within a space.
+- **Activity**: a special hashtag driven by official events.
+
+## Space structure
+
+- Space
+  - Lore/worldbuilding (lore)
+  - Characters
+  - Collections
+  - Sub‑spaces
+    - official_collections
+    - collections
+
+## Workflow
+
+- List all spaces: `list_spaces`
+- Get space details: `get_hashtag_info`
+- Get sub‑spaces: `list_space_topics`
+- Get content in a space or sub‑space: `get_hashtag_collections`, `get_hashtag_characters`
+
+## List available spaces
+
+```bash
+neta-cli list_spaces
+```
+
+**Response fields**
+
+- `space_uuid`: UUID of the space
+- `name`: space name
+- `main_hashtag_name`: main hashtag
+- `topic_count`: number of sub‑spaces (topics)
+
+## Get detailed space info
+
+```bash
+neta-cli get_hashtag_info --hashtag "space_tag_name"
+```
+
+**Response includes:**
+
+- Tag lore (worldbuilding)
+- Activity details
+- Popularity metrics
+- Subscription count
+
+## Get sub‑spaces
+
+```bash
+neta-cli list_space_topics --space_uuid "space UUID"
+```
+
+**Response includes:**
+
+- `primary_topic`: main topic
+- `topics`: list of sub‑spaces
+  - `official_collections`
+
+## Get characters in a space
+
+```bash
+neta-cli get_hashtag_characters --hashtag "space_tag_name" --sort_by "hot"
+```
+
+## Get scenes/events/content in a space
+
+```bash
+neta-cli get_hashtag_collections --hashtag "tag_name"
+```
+
+## Get detailed info for a specific gameplay
+
+```bash
+neta-cli read_collection --uuid "official_collections in topic | collections in hashtag"
+```
+
+## Content creation
+
+For content creation within a space, use the dedicated creative skill:
+
+```bash
+npx skills add talesofai/neta-skills/skills/neta-creative
+```
+