rag-knowledge

Ingest documents and run semantic search over pgvector-backed knowledge collections.

49|11|Updated Jul 31, 2026
One-click install
npx skills add https://github.com/vstorm-co/agenticos --skill rag-knowledge-vstorm-co
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: rag-knowledge
Source: https://github.com/vstorm-co/agenticos/tree/main/.claude/skills/rag-knowledge
Command: npx skills add https://github.com/vstorm-co/agenticos --skill rag-knowledge-vstorm-co

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams cannot answer why an agent fails to find documents that are definitely in a collection, why uploads die silently in workers, or why ingestion 500s on fresh environments. This Skill provides the operational knowledge to populate, debug, and manage a pgvector-based retrieval pipeline. ## Core Features & Use Cases - Document Ingestion: Parse, chunk, embed, and upsert documents into named collections via CLI commands, with heavy ingestion running as a Prefect background flow. - Semantic Search & Collections: Run vector search, list collections, inspect stats, and bind collections to agent specs through the knowledge capability. - Sync Connectors: Add and configure Google Drive or S3 connectors, manage sync sources, and handle per-organization embedding keys from the vault. - Use Case: When a document upload succeeds but never appears in search results, use this Skill to check parser format lists, verify the pgvector database image, and confirm the collection is bound to the agent's spec. ## Quick Start Use the rag-knowledge skill to ingest the docs folder into a collection and run a semantic search query against it.

Frequently Asked Questions about rag-knowledge

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

FAQPage Schema
How do I ingest documents into a pgvector knowledge base?▼

Run the CLI command rag-ingest with a path and collection name, for example rag-ingest ./docs/ --collection docs --recursive. Ingestion parses, chunks, embeds, and upserts documents, with heavy jobs running as a Prefect background flow.

How do I add a Google Drive or S3 sync connector?▼

Implement the connector in app/services/rag/connectors/ following the existing Google Drive and S3 examples, register it so the sync service discovers it, and expose its config fields. The add-sync-connector howto document walks through the process.

Why does document ingestion fail with extension vector is not available?▼

The database must run the pgvector/pgvector:pg16 image because the store issues CREATE EXTENSION IF NOT EXISTS vector on first write. Stock Postgres images lack the extension and return a 500 before any row is committed.

Why did my document upload succeed but never appear in search results?▼

The supported-formats endpoint and the actual document router can disagree, so the upload is accepted but dies in a worker. Also verify the collection is populated with rag-stats and bound to the agent's spec via collection_ids.

Can I mix different embedding models within one collection?▼

No, mixing embeddings within a collection breaks retrieval quality. If the embedding model changes, re-ingest the entire collection so all vectors come from the same model.