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. 1. Visit felo.ai
2. Open Settings -> API Keys
3. Create and copy your API key

2. Configure environment variable

Linux/macOS:

CODEBLOCK0

Windows PowerShell:

CODEBLOCK1

How to Execute

Use Bash tool commands and follow this workflow exactly.

Step 1: Precheck API key

CODEBLOCK2

If key is missing, stop and return setup instructions.

Step 2: Run Node Script

Use the bundled script:

CODEBLOCK3

To specify a layout type:

CODEBLOCK4

Available layout types:

• - MIND_MAP (default) - Classic mind map
• INLINECODE3 - Logical structure diagram
• INLINECODE4 - Organization chart
• INLINECODE5 - Catalog organization chart
• INLINECODE6 - Timeline diagram
• INLINECODE7 - Fishbone diagram

To add mindmap to an existing LiveDoc:

CODEBLOCK5

Script behavior:

• - Creates mindmap via INLINECODE8
• Returns immediately (synchronous API, no polling needed)
• Prints mindmap_url on success

Optional debug output:

CODEBLOCK6

This outputs structured JSON including:

• - INLINECODE10
• INLINECODE11
• INLINECODE12
• INLINECODE13

Step 3: Return structured result

On success, return:

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

Output Format

Use this response structure:

CODEBLOCK7

Error format:

CODEBLOCK8

Error Handling

Known API error codes:

• - INVALID_API_KEY (401): key invalid or revoked
• INLINECODE19 (502): mindmap creation failed
• INLINECODE20 (502): failed to create LiveDoc
• INLINECODE21 (404): specified LiveDoc not found
• INLINECODE22 (503): LLM service is unavailable
• INLINECODE23 (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 Mindmap API
• Felo Open Platform