Felo LiveDoc Skill

When to Use

Trigger this skill when users want to:

• - Create/manage knowledge bases: Create, list, update, or delete LiveDocs
• Add resources: Upload documents, add URLs, or create text documents in a LiveDoc
• Semantic retrieval: Search across knowledge base resources using natural language queries
• Resource management: List, view, or delete resources within a LiveDoc

Trigger words:

• - English: knowledge base, livedoc, live doc, upload document, add URL, semantic search, retrieve, knowledge retrieval
• 简体中文: 知识库, 文档库, 上传文档, 添加链接, 语义检索, 知识检索

Explicit commands: /felo-livedoc, "livedoc", "felo livedoc"

Do NOT use for:

• - General web search (use felo-search)
• PPT generation (use felo-slides)
• SuperAgent conversations (use felo-superAgent)

Setup

1. Get Your API Key

1. 1. Visit felo.ai and log in (or register)
2. Click your avatar in the top right corner → Settings
3. Navigate to the "API Keys" tab
4. Click "Create New Key" to generate a new API Key
5. Copy and save your API Key securely

2. Configure API Key

Set the FELO_API_KEY environment variable:

Linux/macOS:
CODEBLOCK0

Windows (PowerShell):

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

How to Execute

When this skill is triggered, execute the livedoc script using the Bash tool:

LiveDoc Management

Create a LiveDoc:
CODEBLOCK2

List LiveDocs:
CODEBLOCK3

Update a LiveDoc:
CODEBLOCK4

Delete a LiveDoc:
CODEBLOCK5

Resource Management

Add a text document:
CODEBLOCK6

Add URLs (max 10, comma-separated):
CODEBLOCK7

Upload a file:
CODEBLOCK8

List resources:
CODEBLOCK9

Get a single resource:
CODEBLOCK10

Delete a resource:
CODEBLOCK11

Semantic Retrieval

Search across resources:

node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs retrieve SHORT_ID --query "your search query"

Options

All commands support:

• - --json or -j — output raw JSON response
• INLINECODE4 or -t <ms> — request timeout in milliseconds (default: 60000)

Parse and Format Response

The API returns JSON with this structure:
CODEBLOCK13

LiveDoc object:

• - short_id — unique identifier (use this for all operations)
• INLINECODE7 — LiveDoc name
• INLINECODE8 — LiveDoc description
• INLINECODE9 / modified_at — timestamps

Resource object:

• - id — resource identifier
• INLINECODE12 — resource title
• INLINECODE13 — type (web, ai_doc, file, etc.)
• INLINECODE14 — processing status
• INLINECODE15 — content preview

Retrieve result:

• - id — resource ID
• INLINECODE17 — resource title
• INLINECODE18 — matched content
• INLINECODE19 — relevance score (0-1)

Error Handling

Common Error Codes

• - INVALID_API_KEY — API Key is invalid or revoked
• INLINECODE21 — LiveDoc does not exist
• INLINECODE22 — Resource does not exist
• INLINECODE23 — Failed to create LiveDoc
• INLINECODE24 — File upload failed
• INLINECODE25 — URL addition failed
• INLINECODE26 — Semantic retrieval failed

Missing API Key

If FELO_API_KEY is not set, display this message:

CODEBLOCK14

Important Notes

• - Always use the short_id returned from create/list to reference a LiveDoc
• URL resources are limited to 10 per request
• Use --convert with upload to convert files to searchable documents
• Semantic retrieval returns results sorted by relevance score
• Execute immediately using the Bash tool — don't just describe what you would do