# Lumina RAG Knowledge > Manage Lumina's retrieval-augmented generation and knowledge ingestion workflow. Use when editing server/src/services/knowledgeBase.ts, server/src/services/pineconeClient.ts, server/src/scripts/knowledgeCli.ts, server/src/models/KnowledgeSource.ts, files under server/knowledge, manifest-based sync inputs, or debugging grounded answers, retrieval relevance, source lifecycle, and inline citations. Use when this capability is needed. - Skill: `tomevault-io/lumina-rag-knowledge` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/lumina-rag-knowledge` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/lumina-rag-knowledge/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/lumina-rag-knowledge --- # Lumina Rag Knowledge ## Overview Use this skill for retrieval, ingestion, and citation work. The repository treats knowledge management as a CLI-driven flow rather than a UI-managed feature. ## Load The Right Reference - Read `references/cli-workflow.md` when updating or using ingestion commands, manifests, or source files. - Read `references/retrieval-contract.md` when changing runtime retrieval, citation formatting, or grounded-answer behavior. ## Preserve The Grounding Contract - Keep answers grounded in indexed sources. - Preserve inline citations and the associated sources list behavior when changing retrieval or response composition. - Avoid adding UI-based mutation flows for knowledge content unless the task explicitly requires a product change. - Prefer updating source content through the CLI and manifest workflows already documented in the repo. ## Change Source Lifecycle Carefully - Preserve stable `externalId` usage when designing repeatable updates. - Keep ingestion, deletion, listing, and sync semantics coherent across CLI commands and model storage. - If a change affects both retrieval logic and general API behavior, coordinate with `lumina-backend-api`. ## Finish With Practical Validation - Run `npm run build` in `server/` after code changes. - Use the existing CLI commands for targeted runtime checks when environment variables and external services are available. - If Pinecone or Gemini credentials are unavailable, state that runtime retrieval was not exercised. --- > Source: [hoangsonww/AI-RAG-Assistant-Chatbot](https://github.com/hoangsonww/AI-RAG-Assistant-Chatbot) — distributed by [TomeVault](https://tomevault.io).