Agent skill

Felo Livedoc

by Felo-Inc in Felo-Inc/felo-skills

Manage Felo LiveDocs (knowledge bases) and their resources. An agent skill from Felo-Inc/felo-skills.

MITAuto-check passedKnowledge Management

Install Felo Livedoc

skills CLI
$ npx skills add Felo-Inc/felo-skills --skill felo-livedoc -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Felo-Inc/felo-skills felo-livedoc --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Felo-Inc/felo-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/felo-livedoc .claude/skills/felo-livedoc && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
felo-livedoc
GitHub stars
249
Token cost
~2.8k tokens
SKILL.md length
681 words
Files
5 (incl. scripts)
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

Manage Felo LiveDocs (knowledge bases) and their resources. An agent skill from Felo-Inc/felo-skills.

  • Works in 2 steps: Get Your API Key → Configure API Key
  • Users want to create
  • SKILL.md covers When to Use, Setup, How to Execute and Error Handling, plus 1 more section
  • Runs JavaScript scripts from its folder; calls node; reaches felo.ai; needs FELO_API_KEY and INVALID_API_KEY

What it does

Felo Livedoc is an agent skill from Felo-Inc/felo-skills. Manage Felo LiveDocs (knowledge bases) and their resources. Use when users want to create, manage, or query knowledge bases, upload documents, add URLs, or perform semantic retrieval over a knowledge base. Explicit commands: /felo-livedoc.

Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts (for example `README.md` and `clawhub.json`).

It sits in Knowledge Management, covering Knowledge bases. The licence is MIT.

When your agent uses it

  • Users want to create
  • Query knowledge bases
  • Upload documents
  • Perform semantic retrieval over a knowledge base

Example prompts

  • “/felo-livedoc”

Requirements

  • Node.js
  • A credential in FELO_API_KEY
  • A credential in INVALID_API_KEY

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Get Your API Key
  2. Configure API Key

What it can do on your machine

Read from SKILL.md and the folder at commit b42c3c0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • felo.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • FELO_API_KEY
    • INVALID_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Felo Livedoc loads about 2.8k tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 681 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~63
When it runs · the whole SKILL.md, loaded when a task matches
~2.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from Felo-Inc/felo-skills at commit b42c3c0, republished under its MIT licence (© Felo-Inc). 681 words, ~2,762 tokens.

Download SKILL.mdSave it as .claude/skills/felo-livedoc/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
felo-livedoc
description
Manage Felo LiveDocs (knowledge bases) and their resources. Use when users want to create, manage, or query knowledge bases, upload documents, add URLs, or perform semantic retrieval over a knowledge base. Explicit commands: /felo-livedoc.

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
  • Route resources: Find relevant resource IDs by query for targeted retrieval
  • Resource management: List, view, or delete resources within a LiveDoc
  • README management: Get, create, update, append, or delete a LiveDoc's README
  • Task management: Create, update, delete tasks; add comments; view change history

Trigger words:

  • English: knowledge base, livedoc, live doc, upload document, add URL, semantic search, retrieve, knowledge retrieval, route resources, readme, task, task management, comment
  • 简体中文: 知识库, 文档库, 上传文档, 添加链接, 语义检索, 知识检索, 任务, 任务管理, 评论

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. 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:

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

Windows (PowerShell):

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:

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs create --name "KB Name" --description "Description"

List LiveDocs:

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs list
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs list --keyword "search term"

Update a LiveDoc:

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update SHORT_ID --name "New Name" --description "New Desc"

Delete a LiveDoc:

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs delete SHORT_ID
Resource Management

Add a text document:

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs add-doc SHORT_ID --title "Doc Title" --content "Document content here"

Add URLs (max 10, comma-separated):

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs add-urls SHORT_ID --urls "https://example.com,https://example.org"

Each URL can also be passed as a url:title pair using the --url-titles option, or by providing a JSON array. The API accepts both plain strings and {"url": "...", "title": "..."} objects — the script passes them through as-is when using --json mode. To add URLs with custom titles, use the JSON flag and construct the body manually, or rely on the auto-title from the page.

Upload a file:

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs upload SHORT_ID --file ./document.pdf
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs upload SHORT_ID --file ./document.pdf --convert

List resources:

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs resources SHORT_ID

Get a single resource:

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs resource SHORT_ID RESOURCE_ID

Delete a resource:

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs remove-resource SHORT_ID RESOURCE_ID

Update a resource (title/snippet/thumbnail):

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update-resource SHORT_ID RESOURCE_ID --title "New Title"
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update-resource SHORT_ID RESOURCE_ID --snippet "New summary" --thumbnail "https://example.com/thumb.png"

Update resource content (ai_doc type only — also auto-updates snippet from first 2000 bytes):

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update-resource-content SHORT_ID RESOURCE_ID --content "New content here"
Semantic Retrieval

Route relevant resources by query:

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs route SHORT_ID --query "your search query"
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs route SHORT_ID --query "your search query" --max-resources 5

Search across all resources (auto-routes):

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

Search within specific resources:

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs retrieve SHORT_ID --query "your search query" --resource-ids "id1,id2,id3"
Resource File & Content

Download resource source file (get presigned URL):

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs download SHORT_ID RESOURCE_ID
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs download SHORT_ID RESOURCE_ID --expires-in 7200

Get extracted text content of a resource:

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs content SHORT_ID RESOURCE_ID

PPT page deep retrieval:

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs ppt-retrieve SHORT_ID --resource-id RESOURCE_ID --page-number 3 --query "pricing information"
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs ppt-retrieve SHORT_ID --resource-id RESOURCE_ID --page-number 3 --query "pricing information" --max-chunk 5
README Management

Get README:

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs get-readme SHORT_ID

Create or replace README:

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update-readme SHORT_ID --content "# My KB\n\nThis is the README."

Append to README:

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs append-readme SHORT_ID --content "\n\n## New Section\n\nAdditional content."

Delete README:

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs delete-readme SHORT_ID
Task Management

List tasks (with optional filters):

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs tasks SHORT_ID
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs tasks SHORT_ID --status 0
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs tasks SHORT_ID --labels "docs,priority-high"

Create a task:

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs create-task SHORT_ID --title "Write docs" --status 0 --sort 0
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs create-task SHORT_ID --title "Write docs" --status 0 --sort 0 --description "API docs" --labels "docs"
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs create-task SHORT_ID --title "Write docs" --operated-by "claude-code"

Task status values: 0=TODO, 1=IN_PROGRESS, 2=DONE

Update a task (partial update):

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update-task SHORT_ID TASK_ID --status 1
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update-task SHORT_ID TASK_ID --title "New title" --labels "docs,done"
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update-task SHORT_ID TASK_ID --status 2 --operated-by "claude-code"

Delete a task:

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs delete-task SHORT_ID TASK_ID

List task records (comments + change history):

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs task-records SHORT_ID TASK_ID
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs task-records SHORT_ID TASK_ID --record-type comment

Add a comment to a task:

bash
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs add-task-comment SHORT_ID TASK_ID --content "This is a comment."
node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs add-task-comment SHORT_ID TASK_ID --content "This is a comment." --operated-by "claude-code"
Show full SKILL.md (255 more words)Show less
Options

All commands support:

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

The API returns JSON with this structure:

json
{
  "status": "ok",
  "message": "success",
  "data": { ... }
}

LiveDoc object:

  • short_id — unique identifier (use this for all operations)
  • name — LiveDoc name
  • description — LiveDoc description
  • is_shared — true if this LiveDoc was shared with you (not owned by you)
  • created_at / modified_at — timestamps

Resource object:

  • id — resource identifier
  • title — resource title
  • resource_type — type (web, ai_doc, file, etc.)
  • status — processing status
  • snippet — content preview

Retrieve result:

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

Error Handling

Common Error Codes
  • INVALID_API_KEY — API Key is invalid or revoked
  • LIVEDOC_NOT_FOUND — LiveDoc does not exist
  • LIVEDOC_RESOURCE_NOT_FOUND — Resource does not exist
  • LIVEDOC_CREATE_FAILED — Failed to create LiveDoc
  • LIVEDOC_RESOURCE_UPLOAD_FAILED — File upload failed
  • LIVEDOC_RESOURCE_ADD_URLS_FAILED — URL addition failed
  • LIVEDOC_RESOURCE_RETRIEVE_FAILED — Semantic retrieval failed
  • LIVEDOC_README_GET_FAILED — Failed to get README
  • LIVEDOC_README_UPDATE_FAILED — Failed to create or update README
  • LIVEDOC_README_DELETE_FAILED — Failed to delete README
  • LIVEDOC_TASK_LIST_FAILED — Failed to list tasks
  • LIVEDOC_TASK_CREATE_FAILED — Failed to create task
  • LIVEDOC_TASK_UPDATE_FAILED — Failed to update task
  • LIVEDOC_TASK_DELETE_FAILED — Failed to delete task
  • LIVEDOC_TASK_NOT_FOUND — Task does not exist
  • LIVEDOC_TASK_RECORD_LIST_FAILED — Failed to list task records
  • LIVEDOC_TASK_COMMENT_CREATE_FAILED — Failed to add comment
Missing API Key

If FELO_API_KEY is not set, display this message:

ERROR: FELO_API_KEY not set. Get your API key from https://felo.ai (Settings → API Keys).
Set it with: export FELO_API_KEY="your-key"

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

© Felo-Inc, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts) in felo-livedoc of Felo-Inc/felo-skills.

  • SKILL.md
  • LICENSE
  • README.md
  • clawhub.json
  • scripts/run_livedoc.mjs

Open the folder on GitHubat commit b42c3c0

Compare with similar skills

Felo Livedoc next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Felo Livedoc compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Felo Livedoc this skillFelo-Inc/felo-skills249—~2.8kAutomated safety check: PassMIT
Capture Conversationoutline/outline41k—~474Automated safety check: PassCustom licence
Find And Citeoutline/outline41k—~537Automated safety check: PassCustom licence
Xhs Virtual Productchenjin-cmd/xhs-virtual-product726—~862Automated safety check: PassMIT
OpenkbVectifyAI/OpenKB4.8k1 repos~2kAutomated safety check: WarnApache-2.0
Learn From Materialsdmoshehun-prog/learn-from-materials937—~7.9kAutomated safety check: PassMIT

Similar skills

  • Capture Conversation

    outline/outline

    Save the current conversation, a decision, or a set of notes as a document in an Outline collection; use when the user wants to keep what was discussed in their knowledge base.

    41k GitHub stars~474 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Find And Cite

    outline/outline

    Answer questions from the Outline knowledge base with quotes and links to the source documents; use when the user asks what the team knows, documented, or decided about a topic.

    41k GitHub stars~537 tokensUpdated today
    Knowledge ManagementAuto-check passed
  • Xhs Virtual Product

    chenjin-cmd/xhs-virtual-product

    This skill helps plan, select, produce, and market Xiaohongshu (RED) virtual/digital products — templates, knowledge bases, test tools, study materials.

    726 GitHub stars~862 tokensUpdated 9 days ago
    Knowledge ManagementAuto-check passed
  • Openkb

    VectifyAI/OpenKB

    A skill your agent uses when the user asks about content in their OpenKB knowledge base — research topics, concepts compiled from their documents, cross-document synthesis — or mentions openkb, an…

    4.8k GitHub starsUsed in 1 repo~2k tokens
    Knowledge ManagementAuto-check: warnings
  • Learn From Materials

    dmoshehun-prog/learn-from-materials

    Turns books, PDFs, slides and web pages into a source-grounded knowledge base and an interactive learning page in English or Chinese, with quizzes, relationship maps and reusable methodology notes.

    937 GitHub stars~7.9k tokensUpdated 2 days ago
    Knowledge ManagementAuto-check passed
  • Onyx CLI

    onyx-dot-app/onyx

    Query the Onyx knowledge base using the onyx-cli command. An agent skill from onyx-dot-app/onyx.

    32k GitHub starsUsed in 1 repo~2.6k tokens
    Knowledge ManagementAuto-check passed

More from Felo-Inc/felo-skills

All 13 skills in this repo
  • Doc Snapshot Agent

    Felo-Inc/felo-skills

    Automatically illustrate Markdown documents by turning image markers into browser screenshots or AI-generated images, then writing an image-enriched Markdown output.

    249 GitHub stars~5.4k tokensUpdated 2 mo ago
    Auto-check passed
  • Felo Landingpage

    Felo-Inc/felo-skills

    Generate landing pages/webpages with the Felo Landing Page Task API in Claude Code.

    249 GitHub stars~1.4k tokensUpdated 2 mo ago
    Auto-check passed
  • Felo Mindmap

    Felo-Inc/felo-skills

    Generate mindmaps with Felo Mindmap API in Claude Code. An agent skill from Felo-Inc/felo-skills.

    249 GitHub stars~1k tokensUpdated 2 mo ago
    Auto-check passed
  • Felo Search

    Felo-Inc/felo-skills

    Felo AI real-time web search for questions requiring current/live information.

    249 GitHub stars~1.6k tokensUpdated 2 mo ago
    Auto-check passed
  • Felo Slides

    Felo-Inc/felo-skills

    Generate PPT/slides from prompts, local images, PDFs, and other files with the Felo PPT Task API.

    249 GitHub stars~1.5k tokensUpdated 2 mo ago
    Auto-check passed
  • Felo Web Fetch

    Felo-Inc/felo-skills

    Extract webpage content with Felo Web Extract API. An agent skill from Felo-Inc/felo-skills.

    249 GitHub stars~1.7k tokensUpdated 2 mo ago
    Auto-check passed

Questions about Felo Livedoc

What does Felo Livedoc do?

Manage Felo LiveDocs (knowledge bases) and their resources. An agent skill from Felo-Inc/felo-skills. Felo Livedoc is an agent skill from Felo-Inc/felo-skills. Manage Felo LiveDocs (knowledge bases) and their resources.

When should I use Felo Livedoc?

Felo Livedoc fits situations like: users want to create; query knowledge bases; upload documents; perform semantic retrieval over a knowledge base.

How do I install Felo Livedoc in Claude Code?

Run `npx skills add Felo-Inc/felo-skills --skill felo-livedoc -a claude-code`. Or copy the skill folder (felo-livedoc in Felo-Inc/felo-skills) into .claude/skills/felo-livedoc in your project. Claude Code loads it when a task matches its description.

How do I install Felo Livedoc in Codex?

Run `npx skills add Felo-Inc/felo-skills --skill felo-livedoc -a codex`. Or copy the skill folder (felo-livedoc in Felo-Inc/felo-skills) into .agents/skills/felo-livedoc in your project. Codex loads it when a task matches its description.

Can I use Felo Livedoc in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Felo-Inc/felo-skills --skill felo-livedoc -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/felo-livedoc, .gemini/skills/felo-livedoc, .github/skills/felo-livedoc and .opencode/skills/felo-livedoc in your project.

What does Felo Livedoc need to run?

Going by SKILL.md and its folder, Felo Livedoc needs JavaScript for the scripts in its folder, the command-line tools its instructions call (node) and credentials named FELO_API_KEY and INVALID_API_KEY. Our summary lists: Node.js; A credential in FELO_API_KEY; A credential in INVALID_API_KEY.

Does Felo Livedoc access the network?

SKILL.md names 1 domain. In commands or code: felo.ai; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Felo Livedoc safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Felo Livedoc use?

Felo Livedoc is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Felo Livedoc use?

About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Felo Livedoc?

Skills that share tags, products or a category with Felo Livedoc: Capture Conversation (outline/outline, 41k stars), Find And Cite (outline/outline, 41k stars), Xhs Virtual Product (chenjin-cmd/xhs-virtual-product, 726 stars) and Openkb (VectifyAI/OpenKB, 4.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Felo Livedoc?

Felo-Inc (a GitHub organization) maintains it in Felo-Inc/felo-skills, which has 249 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on July 22, 2026.

Source: Felo-Inc/felo-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.