$npx -y skills add talesofai/neta-skills --skill neta-spaceNeta 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 no
| 1 | # Neta Space Skill |
| 2 | |
| 3 | Used to interact with the Neta API to browse space‑level content. |
| 4 | |
| 5 | ## Instructions |
| 6 | |
| 7 | 1. For tasks like **“what spaces/activities exist?”** or **“what is the structure and lore of a given space?”**, organize queries as follows: |
| 8 | 2. Recommended workflow: |
| 9 | - List all spaces. |
| 10 | - For a chosen space, fetch its details (lore, activities, metrics). |
| 11 | - Fetch sub‑spaces and their official/user collections. |
| 12 | - If needed, fetch characters and playable content inside the space. |
| 13 | 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. |
| 14 | |
| 15 | ## Space concepts |
| 16 | |
| 17 | > A space is a themed collection of gameplay experiences — a scene where content is produced and consumed. |
| 18 | |
| 19 | ## Terminology |
| 20 | |
| 21 | - **Hashtag**: tag/space. Used to build worlds and organize communities. |
| 22 | - **Collection**: browseable/remixable/editable content; can also refer to events, scenes, or gameplay within a space. |
| 23 | - **Activity**: a special hashtag driven by official events. |
| 24 | |
| 25 | ## Space structure |
| 26 | |
| 27 | - Space |
| 28 | - Lore/worldbuilding (lore) |
| 29 | - Characters |
| 30 | - Collections |
| 31 | - Sub‑spaces |
| 32 | - official_collections |
| 33 | - collections |
| 34 | |
| 35 | ## Workflow |
| 36 | |
| 37 | - List all spaces: `list_spaces` |
| 38 | - Get space details: `get_hashtag_info` |
| 39 | - Get sub‑spaces: `list_space_topics` |
| 40 | - Get content in a space or sub‑space: `get_hashtag_collections`, `get_hashtag_characters` |
| 41 | |
| 42 | ## List available spaces |
| 43 | |
| 44 | ```bash |
| 45 | npx -y @talesofai/neta-skills@latest list_spaces |
| 46 | ``` |
| 47 | |
| 48 | **Response fields** |
| 49 | |
| 50 | - `space_uuid`: UUID of the space |
| 51 | - `name`: space name |
| 52 | - `main_hashtag_name`: main hashtag |
| 53 | - `topic_count`: number of sub‑spaces (topics) |
| 54 | |
| 55 | ## Get detailed space info |
| 56 | |
| 57 | ```bash |
| 58 | npx -y @talesofai/neta-skills@latest get_hashtag_info --hashtag "space_tag_name" |
| 59 | ``` |
| 60 | |
| 61 | **Response includes:** |
| 62 | |
| 63 | - Tag lore (worldbuilding) |
| 64 | - Activity details |
| 65 | - Popularity metrics |
| 66 | - Subscription count |
| 67 | |
| 68 | ## Get sub‑spaces |
| 69 | |
| 70 | ```bash |
| 71 | npx -y @talesofai/neta-skills@latest list_space_topics --space_uuid "space UUID" |
| 72 | ``` |
| 73 | |
| 74 | **Response includes:** |
| 75 | |
| 76 | - `primary_topic`: main topic |
| 77 | - `topics`: list of sub‑spaces |
| 78 | - `official_collections` |
| 79 | |
| 80 | ## Get characters in a space |
| 81 | |
| 82 | ```bash |
| 83 | npx -y @talesofai/neta-skills@latest get_hashtag_characters --hashtag "space_tag_name" --sort_by "hot" |
| 84 | ``` |
| 85 | |
| 86 | ## Get scenes/events/content in a space |
| 87 | |
| 88 | ```bash |
| 89 | npx -y @talesofai/neta-skills@latest get_hashtag_collections --hashtag "tag_name" |
| 90 | ``` |
| 91 | |
| 92 | ## Get detailed info for a specific gameplay |
| 93 | |
| 94 | ```bash |
| 95 | npx -y @talesofai/neta-skills@latest read_collection --uuid "official_collections in topic | collections in hashtag" |
| 96 | ``` |
| 97 | |
| 98 | ## Content creation |
| 99 | |
| 100 | For content creation within a space, use the dedicated creative skill: |
| 101 | |
| 102 | ```bash |
| 103 | npx skills add talesofai/neta-skills/skills/neta-creative |
| 104 | ``` |