\r \r

Felo Mindmap Skill\r

\r

When to Use\r

\r Trigger this skill for requests about creating mindmap files:\r \r

• Create/generate mindmaps from a topic or question\r
• Turn ideas into a structured mindmap\r
• Build a mindmap with different layout types (timeline, fishbone, etc.)\r
• Export mindmap content into a shareable link\r \r Trigger keywords:\r \r
• Chinese prompts about making mindmaps (思维导图, 脑图)\r
• English: mindmap, mind map, thinking map, generate mindmap\r
• Explicit commands: /felo-mindmap, "use felo mindmap"\r \r Do NOT use this skill for:\r \r
• Real-time information lookup (use felo-search)\r
• Questions about local codebase files\r
• Pure text tasks that do not require mindmap generation\r \r

Setup\r

\r

1. Get API key\r

\r

1. Visit felo.ai\r
2. Open Settings -> API Keys\r
3. Create and copy your API key\r \r

2. Configure environment variable\r

\r Linux/macOS:\r \r

export FELO_API_KEY="your-api-key-here"\r
```\r
\r
Windows PowerShell:\r
\r
```powershell\r
$env:FELO_API_KEY="your-api-key-here"\r
```\r
\r
## How to Execute\r
\r
Use Bash tool commands and follow this workflow exactly.\r
\r
### Step 1: Precheck API key\r
\r
```bash\r
if [ -z "$FELO_API_KEY" ]; then\r
  echo "ERROR: FELO_API_KEY not set"\r
  exit 1\r
fi\r
```\r
\r
If key is missing, stop and return setup instructions.\r
\r
### Step 2: Run Node Script\r
\r
Use the bundled script:\r
\r
```bash\r
node felo-mindmap/scripts/run_mindmap_task.mjs \\r
  --query "USER_PROMPT_HERE" \\r
  --timeout 60\r
```\r
\r
To specify a layout type:\r
\r
```bash\r
node felo-mindmap/scripts/run_mindmap_task.mjs \\r
  --query "USER_PROMPT_HERE" \\r
  --layout "TIMELINE" \\r
  --timeout 60\r
```\r
\r
Available layout types:\r
- `MIND_MAP` (default) - Classic mind map\r
- `LOGICAL_STRUCTURE` - Logical structure diagram\r
- `ORGANIZATION_STRUCTURE` - Organization chart\r
- `CATALOG_ORGANIZATION` - Catalog organization chart\r
- `TIMELINE` - Timeline diagram\r
- `FISHBONE` - Fishbone diagram\r
\r
To add mindmap to an existing LiveDoc:\r
\r
```bash\r
node felo-mindmap/scripts/run_mindmap_task.mjs \\r
  --query "USER_PROMPT_HERE" \\r
  --livedoc-short-id "EXISTING_LIVEDOC_ID"\r
```\r
\r
Script behavior:\r
\r
- Creates mindmap via `POST https://openapi.felo.ai/v2/mindmap`\r
- Returns immediately (synchronous API, no polling needed)\r
- Prints `mindmap_url` on success\r
\r
Optional debug output:\r
\r
```bash\r
node felo-mindmap/scripts/run_mindmap_task.mjs \\r
  --query "USER_PROMPT_HERE" \\r
  --json\r
```\r
\r
This outputs structured JSON including:\r
\r
- `resource_id`\r
- `status`\r
- `mindmap_url`\r
- `livedoc_short_id`\r
\r
### Step 3: Return structured result\r
\r
On success, return:\r
\r
- `mindmap_url` immediately\r
- if `--json` is used, also include `resource_id`, `livedoc_short_id`\r
\r
## Output Format\r
\r
Use this response structure:\r
\r
```markdown\r
## Mindmap Generation Result\r
\r
- Resource ID: \x3Cresource_id>\r
- Status: \x3Cstatus>\r
- Mindmap URL: \x3Cmindmap_url>\r
- LiveDoc Short ID: \x3Clivedoc_short_id>\r
```\r
\r
Error format:\r
\r
```markdown\r
## Mindmap Generation Failed\r
\r
- Error Type: \x3Cerror code or category>\r
- Message: \x3Creadable message>\r
- Suggested Action: \x3Cnext step>\r
```\r
\r
## Error Handling\r
\r
Known API error codes:\r
\r
- `INVALID_API_KEY` (401): key invalid or revoked\r
- `MINDMAP_CREATE_FAILED` (502): mindmap creation failed\r
- `LIVEDOC_CREATE_FAILED` (502): failed to create LiveDoc\r
- `LIVEDOC_NOT_FOUND` (404): specified LiveDoc not found\r
- `LLM_SERVICE_UNAVAILABLE` (503): LLM service is unavailable\r
- `LLM_REQUEST_TIMEOUT` (504): LLM request timed out\r
\r
## Important Notes\r
\r
- Always execute this skill when user intent is mindmap generation.\r
- The API is synchronous - no polling required.\r
- Keep API calls minimal: one request per mindmap.\r
\r
## References\r
\r
- [Felo Mindmap API](https://openapi.felo.ai/docs/api-reference/v2/mindmap.html)\r
- [Felo Open Platform](https://openapi.felo.ai/docs/)