Neta Suggest logo

Neta Suggest

Organization
netaart
neta-suggest

Neta API research and recommendation skill — provide keyword/tag/category suggestions, validate taxonomy paths, and power multi‑mode content feeds, supporting progressive exploration from broad to precise. Use this skill when the user has no clear goal, wants topic/idea suggestions, or needs systematic content filtering by keywords/categories. It does not directly generate media (handled by neta-creative); community interactions are handled by neta-community.

Overview

Publishernetaart
Repositoryneta-skills
Skill nameneta-suggest
Stars
662
Forks
9
Bundled files
Instructions only
LicenseMIT
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • Self-contained

    Everything the model needs lives in the instructions — no extra files to sync.

  • Open source

    Published by netaart on GitHub. Read the source before you install it.

Installation

Install the Neta Suggest AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/netaart/neta-skills/tree/main/skills/neta-suggest
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/netaart/neta-skills.git /tmp/neta-skills
mkdir -p .claude/skills
cp -r /tmp/neta-skills/skills/neta-suggest .claude/skills/neta-suggest
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Neta Suggest in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Neta Suggest on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Neta Suggest is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

Neta Suggest Skill

Instructions

  1. For research‑type tasks like “find me some ideas”, “what’s trending now”, or “filter content by a theme/category”, follow this flow:
  2. Recommended path: browse categories → discover tags → validate paths → fetch content (the “Progressive Exploration” section below contains full command examples).
  3. Before content creation, use this skill to research topics/tags/categories, then hand off to neta-creative for concrete creation.
  4. When the user wants to like/comment or otherwise interact with specific works, switch to neta-community.

Core capabilities

1. suggest_keywords — keyword suggestions

Provide popular search keyword suggestions based on an input prefix, helping users discover directions of interest.

bash
npx -y @talesofai/neta-skills@latest suggest_keywords --prefix "game" --size 20

Parameters

  • --prefix: keyword prefix (required)
  • --size: number of results, recommended 10–20 (optional)

Use cases

  • User only has a vague idea.
  • Explore trending topics and themes.
  • Prepare for later precise filtering.

2. suggest_tags — related tag suggestions

Recommend related taxonomy tags based on a full keyword.

bash
npx -y @talesofai/neta-skills@latest suggest_tags --keyword "character design" --size 15

Parameters

  • --keyword: full keyword (required)
  • --size: number of results, recommended 10–20 (optional)

Use cases

  • Understand which tags surround a topic.
  • Discover popular tags in a vertical domain.
  • Choose suitable tags for publishing content.

3. suggest_categories — category navigation

Provide navigation suggestions in a 3‑level category hierarchy, supporting step‑by‑step exploration.

bash
# Level 1 (top‑level categories)
npx -y @talesofai/neta-skills@latest suggest_categories --level 1

# Level 2 (requires parent path)
npx -y @talesofai/neta-skills@latest suggest_categories --level 2 --parent_path "Derivative Creation"

# Level 3 (most granular)
npx -y @talesofai/neta-skills@latest suggest_categories --level 3 --parent_path "Derivative Creation>Fan Works"

Parameters

  • --level: category level (1/2/3) (required)
  • --parent_path: parent category path, required when level > 1 (optional)

Example taxonomy

text
Level 1
├─ Derivative Creation
│  ├─ Fan Works (Level 2)
│  │  ├─ Honkai: Star Rail (Level 3)
│  │  └─ Genshin Impact (Level 3)
│  └─ Digital Art
├─ Lifestyle
└─ ...

Use cases

  • Systematically understand the platform’s category structure.
  • Navigate by following the tree to find specific domains.
  • Validate candidate category paths.

4. validate_tax_path — validate taxonomy path

Validate that a taxonomy path string is valid before using it.

bash
npx -y @talesofai/neta-skills@latest validate_tax_path --tax_path "Derivative Creation>Fan Works>Honkai: Star Rail"

Parameters

  • --tax_path: full taxonomy path (required)

Use cases

  • Validate paths before using them in filters.
  • Ensure taxonomy paths are accurate.

5. suggest_content — intelligent content feed

Powerful content recommendation tool supporting three modes: recommend, search, and exact.

bash
# Mode 1: recommend (broad exploration)
npx -y @talesofai/neta-skills@latest suggest_content \
  --page_index 0 \
  --page_size 20 \
  --scene agent_intent \
  --intent recommend

# Mode 2: search (keyword‑based)
npx -y @talesofai/neta-skills@latest suggest_content \
  --page_index 0 \
  --page_size 20 \
  --scene agent_intent \
  --intent search \
  --search_keywords "character,creativity"

# Mode 3: exact (category filtering)
npx -y @talesofai/neta-skills@latest suggest_content \
  --page_index 0 \
  --page_size 20 \
  --scene agent_intent \
  --intent exact \
  --tax_paths "Derivative Creation>Fan Works"

# Combined filters
npx -y @talesofai/neta-skills@latest suggest_content \
  --page_index 0 \
  --page_size 20 \
  --scene agent_intent \
  --intent search \
  --search_keywords "AI,painting" \
  --tax_paths "Digital Art>Concept Art" \
  --exclude_keywords "test,discarded"

Parameters

  • --page_index: page index, starting from 0 (default 0)
  • --page_size: items per page, 1–40 (default 20)
  • --scene: scene identifier (default "agent_intent")
  • --biz_trace_id: session trace ID (optional)
  • --intent: recommend | search | exact (default recommend)
  • --search_keywords: search keywords, separated by commas (optional)
  • --tax_paths: taxonomy paths, separated by commas (optional)
  • --tax_primaries: level‑1 categories (optional)
  • --tax_secondaries: level‑2 categories (optional)
  • --tax_tertiaries: level‑3 categories (optional)
  • --exclude_keywords: excluded keywords (optional)
  • --exclude_tax_paths: excluded taxonomy paths (optional)

Progressive exploration

Standard path (broad → narrow)

text
graph LR
    A[Browse categories] --> B[Discover tags]
    B --> C[Validate paths]
    C --> D[Fetch content]
Step 1: browse category system
bash
# View all level‑1 categories
npx -y @talesofai/neta-skills@latest suggest_categories --level 1
# Example output: ["Derivative Creation", "Digital Art", "Lifestyle"]

# Dive into an interesting category
npx -y @talesofai/neta-skills@latest suggest_categories --level 2 --parent_path "Derivative Creation"
# Example: ["Fan Works", "Original Stories", "Interactive Fiction"]
Step 2: discover related tags
bash
# Find tags from a keyword
npx -y @talesofai/neta-skills@latest suggest_tags --keyword "Fan Works" --size 15
# Example: ["Honkai: Star Rail", "Genshin Impact", "Arknights"]

# Use keyword suggestions to help
npx -y @talesofai/neta-skills@latest suggest_keywords --prefix "Hon" --size 10
Step 3: validate taxonomy path
bash
npx -y @talesofai/neta-skills@latest validate_tax_path \
  --tax_path "Derivative Creation>Fan Works>Honkai: Star Rail"
Step 4: fetch recommended content
bash
# Exact mode: filter by taxonomy only
npx -y @talesofai/neta-skills@latest suggest_content \
  --intent exact \
  --tax_paths "Derivative Creation>Fan Works>Honkai: Star Rail" \
  --page_size 20

# Search mode: combine keyword and taxonomy
npx -y @talesofai/neta-skills@latest suggest_content \
  --intent search \
  --search_keywords "Honkai: Star Rail,fan art" \
  --tax_paths "Derivative Creation>Fan Works" \
  --page_size 20

Common scenarios

Scenario 1: exploration without a clear goal

User is just browsing with no specific goal.

bash
npx -y @talesofai/neta-skills@latest suggest_content \
  --intent recommend \
  --page_size 20

Tips:

  • Avoid constraints at first.
  • Let the system recommend based on popularity.
  • Good for serendipitous discovery.

Scenario 2: vague interest direction

User has a rough topic in mind but not specific content.

bash
# Step 1: keyword suggestions
npx -y @talesofai/neta-skills@latest suggest_keywords --prefix "game" --size 15

# Step 2: tag suggestions
npx -y @talesofai/neta-skills@latest suggest_tags --keyword "game" --size 15

# Step 3: search mode
npx -y @talesofai/neta-skills@latest suggest_content \
  --intent search \
  --search_keywords "Genshin Impact" \
  --page_size 20

Scenario 3: clear category goal

bash
# Step 1: confirm taxonomy path
npx -y @talesofai/neta-skills@latest suggest_categories --level 1
npx -y @talesofai/neta-skills@latest suggest_categories --level 2 --parent_path "Derivative Creation"

# Step 2: validate path
npx -y @talesofai/neta-skills@latest validate_tax_path \
  --tax_path "Derivative Creation>Fan Works>Honkai: Star Rail"

# Step 3: exact filter
npx -y @talesofai/neta-skills@latest suggest_content \
  --intent exact \
  --tax_paths "Derivative Creation>Fan Works>Honkai: Star Rail" \
  --page_size 20

Scenario 4: pre‑creation research

bash
# Step 1: understand popular tags
npx -y @talesofai/neta-skills@latest suggest_tags --keyword "character writing" --size 20

# Step 2: inspect related categories
npx -y @talesofai/neta-skills@latest suggest_categories --level 2 --parent_path "Derivative Creation"

# Step 3: view popular content under that category
npx -y @talesofai/neta-skills@latest suggest_content \
  --intent search \
  --search_keywords "character,setting" \
  --tax_paths "Derivative Creation>Fan Works" \
  --page_size 30

Scenario 5: excluding unwanted content

bash
npx -y @talesofai/neta-skills@latest suggest_content \
  --intent search \
  --search_keywords "AI,painting" \
  --tax_paths "Digital Art" \
  --exclude_keywords "tutorial,ad" \
  --exclude_tax_paths "Digital Art>Courses" \
  --page_size 20

Parameter combination tips

Combination 1: keyword + taxonomy

bash
npx -y @talesofai/neta-skills@latest suggest_content \
  --intent search \
  --search_keywords "video,editing" \
  --tax_paths "Digital Art>Video Production" \
  --page_size 20

Combination 2: multi‑level taxonomy

bash
npx -y @talesofai/neta-skills@latest suggest_content \
  --intent exact \
  --tax_paths "Derivative Creation>Fan Works>Honkai: Star Rail" \
  --page_size 20

Combination 3: recommend + exclusions

bash
npx -y @talesofai/neta-skills@latest suggest_content \
  --intent recommend \
  --exclude_keywords "tutorial, repost" \
  --exclude_tax_paths "Courses" \
  --page_size 20

Combination 4: pagination continuity

bash
# Page 1
npx -y @talesofai/neta-skills@latest suggest_content \
  --page_index 0 \
  --page_size 20 \
  --intent search \
  --search_keywords "ideas" > /tmp/page0.json

# Extract biz_trace_id
BIZ_TRACE_ID=$(cat /tmp/page0.json | jq -r '.page_data.biz_trace_id')

# Page 2 (reuse same biz_trace_id)
npx -y @talesofai/neta-skills@latest suggest_content \
  --page_index 1 \
  --page_size 20 \
  --intent search \
  --search_keywords "ideas" \
  --biz_trace_id "$BIZ_TRACE_ID"

Output formats

suggest_keywords / suggest_tags / suggest_categories

json
{
  "suggestions": ["Suggestion 1", "Suggestion 2", "Suggestion 3"]
}

validate_tax_path

Valid path:

json
{
  "valid": true,
  "message": "Path is valid"
}

Invalid path:

json
{
  "valid": false,
  "message": "Error message"
}

suggest_content

json
{
  "module_list": [
    {
      "data_id": "module id",
      "module_id": "module type",
      "template_id": "template id",
      "json_data": {}
    }
  ],
  "page_data": {
    "has_next_page": true,
    "page_index": 0,
    "page_size": 20,
    "biz_trace_id": "trace id"
  }
}

Performance tips

  1. Choose page_size wisely
    • Exploration: 10–15 for quick iteration.
    • Deep browsing: 20–30 to reduce page switches.
    • Precise lookup: 20–40 to fetch enough content at once.
  2. Cache suggestions
    • Cache taxonomy and tag suggestions to avoid repeated calls.
  3. Preload next‑level categories
    • While the user is viewing level‑1 categories, preload level‑2 categories in the background.
  4. Batch‑validate taxonomy paths
    • Validate multiple candidate paths in parallel or via a simple script.

Debugging tips

  1. Turn on debug logs for suggest_content to verify parameters.
  2. Use exact mode with only taxonomy to test whether a path actually returns content.
  3. Compare recommend, search, and exact with the same topic to understand their differences.

FAQ

Q1: What’s the difference between suggest_keywords and suggest_tags?

  • suggest_keywords: prefix‑based fuzzy matching, good for early exploration.
  • suggest_tags: relevance‑based matching on full keywords, more precise.

Q2: Why does validate_tax_path succeed but suggest_content return empty?

Possible reasons:

  1. The taxonomy path is valid but currently has no content.
  2. Wrong intent mode (e.g., using recommend instead of exact).
  3. Other filters conflict.

Q3: How to choose the right intent?

IntentUse caseRequired params
recommendBrowsing without clear goalNone
searchKeyword‑driven searchsearch_keywords
exactStrict category filteringtax_paths or taxonomy params

Q4: How to use exclude_keywords and exclude_tax_paths?

Use them to aggressively filter noise content, but note they can significantly reduce result count.

Q5: How to maintain biz_trace_id across pages?

Always keep and reuse the first biz_trace_id returned for a given query instead of chaining from page to page.

Summary

Key points for using the exploration skill:

  1. Progressive exploration: Categories → Tags → Validation → Content.
  2. Intent selection: recommend for aimless browsing, search for keyword queries, exact for strict taxonomy.
  3. Combination filters: combine keywords with taxonomy for precise control.
  4. Exclusions: use exclude_* parameters judiciously to filter noise.
  5. Session continuity: maintain a consistent biz_trace_id for stable paging behavior.

By following these practices, you can explore and discover high‑quality content on the platform efficiently.

Frequently asked questions

What does the Neta Suggest AI skill do?

Neta API research and recommendation skill — provide keyword/tag/category suggestions, validate taxonomy paths, and power multi‑mode content feeds, supporting progressive exploration from broad to precise. Use this skill when the user has no clear goal, wants topic/idea suggestions, or needs systematic content filtering by keywords/categories. It does not directly generate media (handled by neta-creative); community interactions are handled by neta-community.

Why use Neta Suggest on TypingMind?

Because you install it once and use it with any model. Neta Suggest is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Neta Suggest in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/netaart/neta-skills/tree/main/skills/neta-suggest. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use Neta Suggest?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Neta Suggest?

As many as you like. As long as a model supports skills, you can use Neta Suggest with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Neta Suggest AI skill free?

Yes. It is published on GitHub by netaart under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇