Agent skill

Felo Mindmap

by Felo-Inc in Felo-Inc/felo-skills

Generate mindmaps with Felo Mindmap API in Claude Code. An agent skill from Felo-Inc/felo-skills.

MITAuto-check passed

Install Felo Mindmap

skills CLI
$ npx skills add Felo-Inc/felo-skills --skill felo-mindmap -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Felo-Inc/felo-skills felo-mindmap --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Felo-Inc/felo-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/felo-mindmap .claude/skills/felo-mindmap && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
felo-mindmap
GitHub stars
248
Token cost
~1k tokens
SKILL.md length
323 words
Files
5 (incl. scripts)
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

Generate mindmaps with Felo Mindmap API in Claude Code. An agent skill from Felo-Inc/felo-skills.

  • Works in 5 steps: Get API key → Configure environment variable → Precheck API key → …
  • Users ask to create/make/generate mindmaps
  • SKILL.md covers When to Use, Setup, How to Execute and Output Format, plus 3 more sections
  • Runs JavaScript scripts from its folder; calls node; reaches openapi.felo.ai; needs FELO_API_KEY and INVALID_API_KEY

What it does

Felo Mindmap is an agent skill from Felo-Inc/felo-skills. Generate mindmaps with Felo Mindmap API in Claude Code. Use when users ask to create/make/generate mindmaps, mind maps, or thinking maps, or when explicit commands like /felo-mindmap are used. Handles API key check, mindmap creation with various layouts, and final mindmapurl output.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts (for example `README.md` and `clawhub.json`).

The licence is MIT.

When your agent uses it

  • Users ask to create/make/generate mindmaps
  • Explicit commands like /felo-mindmap are used

Example prompts

  • “/felo-mindmap”

Requirements

  • Node.js
  • A credential in FELO_API_KEY
  • A credential in INVALID_API_KEY

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Get API key
  2. Configure environment variable
  3. Precheck API key
  4. Run Node Script
  5. Return structured result

What it can do on your machine

Read from SKILL.md and the folder at commit b42c3c0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • openapi.felo.ai

    Also links to:

    • felo.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • FELO_API_KEY
    • INVALID_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Felo Mindmap loads about 1k tokens when it runs. Until then it costs about 74 tokens; SKILL.md has 323 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~74
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from Felo-Inc/felo-skills at commit b42c3c0, republished under its MIT licence (© Felo-Inc). 323 words, ~1,004 tokens.

Download SKILL.mdSave it as .claude/skills/felo-mindmap/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
felo-mindmap
description
Generate mindmaps with Felo Mindmap API in Claude Code. Use when users ask to create/make/generate mindmaps, mind maps, or thinking maps, or when explicit commands like /felo-mindmap are used. Handles API key check, mindmap creation with various layouts, and final mindmap_url output.

Felo Mindmap Skill

When to Use

Trigger this skill for requests about creating mindmap files:

  • Create/generate mindmaps from a topic or question
  • Turn ideas into a structured mindmap
  • Build a mindmap with different layout types (timeline, fishbone, etc.)
  • Export mindmap content into a shareable link

Trigger keywords:

  • Chinese prompts about making mindmaps (思维导图, 脑图)
  • English: mindmap, mind map, thinking map, generate mindmap
  • Explicit commands: /felo-mindmap, "use felo mindmap"

Do NOT use this skill for:

  • Real-time information lookup (use felo-search)
  • Questions about local codebase files
  • Pure text tasks that do not require mindmap generation

Setup

1. Get API key
  1. Visit felo.ai
  2. Open Settings -> API Keys
  3. Create and copy your API key
2. Configure environment variable

Linux/macOS:

bash
export FELO_API_KEY="your-api-key-here"

Windows PowerShell:

powershell
$env:FELO_API_KEY="your-api-key-here"

How to Execute

Use Bash tool commands and follow this workflow exactly.

Step 1: Precheck API key
bash
if [ -z "$FELO_API_KEY" ]; then
  echo "ERROR: FELO_API_KEY not set"
  exit 1
fi

If key is missing, stop and return setup instructions.

Step 2: Run Node Script

Use the bundled script:

bash
node felo-mindmap/scripts/run_mindmap_task.mjs \
  --query "USER_PROMPT_HERE" \
  --timeout 60

To specify a layout type:

bash
node felo-mindmap/scripts/run_mindmap_task.mjs \
  --query "USER_PROMPT_HERE" \
  --layout "TIMELINE" \
  --timeout 60

Available layout types:

  • MIND_MAP (default) - Classic mind map
  • LOGICAL_STRUCTURE - Logical structure diagram
  • ORGANIZATION_STRUCTURE - Organization chart
  • CATALOG_ORGANIZATION - Catalog organization chart
  • TIMELINE - Timeline diagram
  • FISHBONE - Fishbone diagram

To add mindmap to an existing LiveDoc:

bash
node felo-mindmap/scripts/run_mindmap_task.mjs \
  --query "USER_PROMPT_HERE" \
  --livedoc-short-id "EXISTING_LIVEDOC_ID"

Script behavior:

  • Creates mindmap via POST https://openapi.felo.ai/v2/mindmap
  • Returns immediately (synchronous API, no polling needed)
  • Prints mindmap_url on success

Optional debug output:

bash
node felo-mindmap/scripts/run_mindmap_task.mjs \
  --query "USER_PROMPT_HERE" \
  --json

This outputs structured JSON including:

  • resource_id
  • status
  • mindmap_url
  • livedoc_short_id
Step 3: Return structured result

On success, return:

  • mindmap_url immediately
  • if --json is used, also include resource_id, livedoc_short_id

Output Format

Use this response structure:

markdown
## Mindmap Generation Result

- Resource ID: <resource_id>
- Status: <status>
- Mindmap URL: <mindmap_url>
- LiveDoc Short ID: <livedoc_short_id>

Error format:

markdown
## Mindmap Generation Failed

- Error Type: <error code or category>
- Message: <readable message>
- Suggested Action: <next step>

Error Handling

Known API error codes:

  • INVALID_API_KEY (401): key invalid or revoked
  • MINDMAP_CREATE_FAILED (502): mindmap creation failed
  • LIVEDOC_CREATE_FAILED (502): failed to create LiveDoc
  • LIVEDOC_NOT_FOUND (404): specified LiveDoc not found
  • LLM_SERVICE_UNAVAILABLE (503): LLM service is unavailable
  • LLM_REQUEST_TIMEOUT (504): LLM request timed out

Important Notes

  • Always execute this skill when user intent is mindmap generation.
  • The API is synchronous - no polling required.
  • Keep API calls minimal: one request per mindmap.

References

© Felo-Inc, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts) in felo-mindmap of Felo-Inc/felo-skills.

  • SKILL.md
  • LICENSE
  • README.md
  • clawhub.json
  • scripts/run_mindmap_task.mjs

Open the folder on GitHubat commit b42c3c0

Compare with similar skills

Felo Mindmap next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Felo Mindmap compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Felo Mindmap this skillFelo-Inc/felo-skills248—~1kAutomated safety check: PassMIT
MindmapZJU-REAL/Easel3.2k—~362Automated safety check: PassApache-2.0
Mindmapaipoch/medical-research-skills2k—~1.7kAutomated safety check: PassMIT
Mindmap Generatorjeremylongshore/tons-of-skills-marketplace2.8k—~555Automated safety check: PassMIT
Mindmap HTML Generatoraipoch/medical-research-skills2k—~2.7kAutomated safety check: PassMIT
Mindmap Helperaipoch/medical-research-skills2k—~2kAutomated safety check: PassMIT

Similar skills

  • Mindmap

    ZJU-REAL/Easel

    思维导图:把 Markdown 大纲(标题层级 + 列表)渲染成可交互思维导图 HTML,可选导出 PNG。适合知识结构、内容框架、SWOT、脑图梳理。当用户说 思维导图、脑图、mindmap、知识导图、大纲图、把要点做成脑图、内容结构图、SWOT图、树状图 时使用。基于 shared/scripts/mindmap.py(markmap 自包含 HTML + Chromium 渲染…

    3.2k GitHub stars~362 tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Mindmap

    aipoch/medical-research-skills

    Generate mindmaps locally/offline with native HTML/CSS/JS (no external libraries); use when you need to parse Plain Text node structures or map LLM outputs into an on-device visualization.

    2k GitHub stars~1.7k tokensUpdated 21 days ago
    Auto-check passed
  • Mindmap Generator

    jeremylongshore/tons-of-skills-marketplace

    Generate mindmap generator operations. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~555 tokensUpdated today
    DevelopmentAuto-check passed
  • Mindmap HTML Generator

    aipoch/medical-research-skills

    Generate offline interactive mindmap HTML and convert Markdown, outlines, meeting notes, chapter structures, or JSON trees into markmap-compatible format.

    2k GitHub stars~2.7k tokensUpdated 21 days ago
    Productivity & AutomationAuto-check passed
  • Mindmap Helper

    aipoch/medical-research-skills

    Organize requirements into Markdown/JSON mind map structures; use when you need a hierarchical outline for mind map tools (e.g., XMind, ProcessOn, FreeMind) or for documentation planning.

    2k GitHub stars~2k tokensUpdated 21 days ago
    Documents & OfficeAuto-check passed
  • Mindmap

    serenakeyitan/open-exam-skills

    Create interactive mind maps from notes or outlines. An agent skill from serenakeyitan/open-exam-skills.

    144 GitHub stars~1.2k tokensUpdated 8 mo ago
    Frontend & DesignAuto-check passed

More from Felo-Inc/felo-skills

All 13 skills in this repo
  • Doc Snapshot Agent

    Felo-Inc/felo-skills

    Automatically illustrate Markdown documents by turning image markers into browser screenshots or AI-generated images, then writing an image-enriched Markdown output.

    248 GitHub stars~5.4k tokensUpdated 2 mo ago
    Auto-check passed
  • Felo Landingpage

    Felo-Inc/felo-skills

    Generate landing pages/webpages with the Felo Landing Page Task API in Claude Code.

    248 GitHub stars~1.4k tokensUpdated 2 mo ago
    Auto-check passed
  • Felo Livedoc

    Felo-Inc/felo-skills

    Manage Felo LiveDocs (knowledge bases) and their resources. An agent skill from Felo-Inc/felo-skills.

    248 GitHub stars~2.8k tokensUpdated 2 mo ago
    Auto-check passed
  • Felo Search

    Felo-Inc/felo-skills

    Felo AI real-time web search for questions requiring current/live information.

    248 GitHub stars~1.6k tokensUpdated 2 mo ago
    Auto-check passed
  • Felo Slides

    Felo-Inc/felo-skills

    Generate PPT/slides from prompts, local images, PDFs, and other files with the Felo PPT Task API.

    248 GitHub stars~1.5k tokensUpdated 2 mo ago
    Auto-check passed
  • Felo Web Fetch

    Felo-Inc/felo-skills

    Extract webpage content with Felo Web Extract API. An agent skill from Felo-Inc/felo-skills.

    248 GitHub stars~1.7k tokensUpdated 2 mo ago
    Auto-check passed

Questions about Felo Mindmap

What does Felo Mindmap do?

Generate mindmaps with Felo Mindmap API in Claude Code. An agent skill from Felo-Inc/felo-skills. Felo Mindmap is an agent skill from Felo-Inc/felo-skills. Generate mindmaps with Felo Mindmap API in Claude Code.

When should I use Felo Mindmap?

Felo Mindmap fits situations like: users ask to create/make/generate mindmaps; explicit commands like /felo-mindmap are used.

How do I install Felo Mindmap in Claude Code?

Run `npx skills add Felo-Inc/felo-skills --skill felo-mindmap -a claude-code`. Or copy the skill folder (felo-mindmap in Felo-Inc/felo-skills) into .claude/skills/felo-mindmap in your project. Claude Code loads it when a task matches its description.

How do I install Felo Mindmap in Codex?

Run `npx skills add Felo-Inc/felo-skills --skill felo-mindmap -a codex`. Or copy the skill folder (felo-mindmap in Felo-Inc/felo-skills) into .agents/skills/felo-mindmap in your project. Codex loads it when a task matches its description.

Can I use Felo Mindmap in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Felo-Inc/felo-skills --skill felo-mindmap -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/felo-mindmap, .gemini/skills/felo-mindmap, .github/skills/felo-mindmap and .opencode/skills/felo-mindmap in your project.

What does Felo Mindmap need to run?

Going by SKILL.md and its folder, Felo Mindmap needs JavaScript for the scripts in its folder, the command-line tools its instructions call (node) and credentials named FELO_API_KEY and INVALID_API_KEY. Our summary lists: Node.js; A credential in FELO_API_KEY; A credential in INVALID_API_KEY.

Does Felo Mindmap access the network?

SKILL.md names 2 domains. In commands or code: openapi.felo.ai; the agent is likely to contact it when it follows the instructions. As links in the text: felo.ai. This is read from the text; nothing was executed.

Is Felo Mindmap safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Felo Mindmap use?

Felo Mindmap is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Felo Mindmap use?

About 1k tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Felo Mindmap?

Skills that share tags, products or a category with Felo Mindmap: Mindmap (ZJU-REAL/Easel, 3.2k stars), Mindmap (aipoch/medical-research-skills, 2k stars), Mindmap Generator (jeremylongshore/tons-of-skills-marketplace, 2.8k stars) and Mindmap HTML Generator (aipoch/medical-research-skills, 2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Felo Mindmap?

Felo-Inc (a GitHub organization) maintains it in Felo-Inc/felo-skills, which has 248 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on July 22, 2026.

Source: Felo-Inc/felo-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.