light-rag

Manage and query local LightRAG knowledge bases via the ragcli CLI.

Updated May 10, 2026
One-click install
npx skills add https://github.com/cookkie03/skills --skill light-rag-cookkie03
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: light-rag
Source: https://github.com/cookkie03/skills/tree/main/light-rag
Command: npx skills add https://github.com/cookkie03/skills --skill light-rag-cookkie03

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Scattered documents and notes are hard to search, and re-reading source files by hand wastes time. This Skill lets you create, manage, and query local LightRAG knowledge bases through the ragcli CLI so answers come from an indexed KB instead of manual grep/find. ## Core Features & Use Cases - KB Discovery First: List existing knowledge bases with ragcli kb ls or ragcli status before creating anything, avoiding duplicate KBs. - Query & Server Lifecycle: Run non-interactive queries against a KB, and start or check its server when it is down. - Create & Ingest: Create new KBs with chosen OCR and provider settings, ingest source folders, and handle maintenance tasks like resetting or moving a KB. - Use Case: A user asks "what do we know about waste recycling?" — the Skill checks the registry, finds the 'riciclo' KB, starts its server if needed, and runs a mix-mode query to return the answer. ## Quick Start Ask the assistant to list all existing ragcli knowledge bases and query the one matching your topic, for example "check the KB for what we know about recycling goals".

Frequently Asked Questions about light-rag

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query a LightRAG knowledge base with ragcli?

Run ragcli query -h to see current flags, then execute the query non-interactively against the target KB. If the KB server is not running, the status or server subcommand will indicate it, and you can start it the same way.

How do I create a new knowledge base with ragcli?

First run ragcli kb ls to confirm no existing KB covers the topic. Then check ragcli kb -h and ragcli ingest -h for the create and ingest subcommands, specifying options like the source folder, OCR engine, and provider.

Where does ragcli store knowledge base configuration?

Global configuration lives in ~/Documents/lightrag-kb/config/global.env, while the KB registry with names, ports, sources, and providers is stored in ~/Documents/lightrag-kb/registry.yaml.

What should I do if a ragcli KB server is not running?

Check the server state with ragcli status or the server subcommand. If the KB is down, start it using the server subcommand after checking its -h help output for the correct syntax.

When should I create a new KB instead of querying an existing one?

Only create a new KB after ragcli kb ls shows no existing KB covers the topic. Querying an existing KB avoids re-reading source files manually and prevents duplicate knowledge bases.