felo-mindmap
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.
How do I install this agent skill?
npx skills add https://github.com/felo-inc/felo-skills --skill felo-mindmapIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The Felo Mindmap skill enables users to create various types of mindmaps (like fishbone or timeline diagrams) via the Felo Mindmap API. It uses a provided Node.js script to communicate with the vendor's infrastructure using an API key stored in environment variables. The skill's implementation is transparent and follows standard practices for API-based tools.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
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 mapLOGICAL_STRUCTURE- Logical structure diagramORGANIZATION_STRUCTURE- Organization chartCATALOG_ORGANIZATION- Catalog organization chartTIMELINE- Timeline diagramFISHBONE- 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_urlon success
Optional debug output:
node felo-mindmap/scripts/run_mindmap_task.mjs \
--query "USER_PROMPT_HERE" \
--json
This outputs structured JSON including:
resource_idstatusmindmap_urllivedoc_short_id
Step 3: Return structured result
On success, return:
mindmap_urlimmediately- if
--jsonis used, also includeresource_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 revokedMINDMAP_CREATE_FAILED(502): mindmap creation failedLIVEDOC_CREATE_FAILED(502): failed to create LiveDocLIVEDOC_NOT_FOUND(404): specified LiveDoc not foundLLM_SERVICE_UNAVAILABLE(503): LLM service is unavailableLLM_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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/felo-inc/felo-skills/felo-mindmap">View felo-mindmap on skillZs</a>