felo-mindmap

Q: How do I install felo-mindmap?

Run npx skills add https://github.com/felo-inc/felo-skills --skill felo-mindmap in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/felo-mindmap/ (personal) or .claude/skills/felo-mindmap/ (project).

by felo-incBackend & APIs

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.

Installs: 67
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/felo-inc/felo-skills --skill felo-mindmap

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads felo-mindmap automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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

Visit felo.ai
Open Settings -> API Keys
Create and copy your API key

2. Configure environment variable

Linux/macOS:

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

Windows 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

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:

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

To specify a layout type:

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:

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:

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:

## Mindmap Generation Result

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

Error format:

## 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

FAQ

What does the felo-mindmap skill do?

How do I install felo-mindmap?

Run npx skills add https://github.com/felo-inc/felo-skills --skill felo-mindmap in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/felo-mindmap/ (personal) or .claude/skills/felo-mindmap/ (project).

Which AI agents can use felo-mindmap?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is felo-mindmap safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains felo-mindmap?

It is published by felo-inc in felo-inc/felo-skills. It has 67 recorded installs.

More from felo-inc/felo-skills

View all →

felo-slides

felo-inc/felo-skills

Generate PPT/slides from prompts, local images, PDFs, and other files with the Felo PPT Task API. Use when users ask to create, make, generate, or export presentations or slide decks; turn an attached/local file into slides; include an original image in a PPT; or explicitly invoke /felo-slides. Handles file upload, API key checks, task creation, polling, and final ppturl output.

Docs & Writing1K installs