Journey rag

Skill butterbase-ai/butterbase-skills/skills/journey-rag

Plugin for Butterbase.ai

Install

npx -y skills add butterbase-ai/butterbase-skills --skill journey-rag

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

Use as the RAG build stage of the Butterbase journey. Implements the RAG section of 02-plan.md by delegating to rag-dev. Calls manage_rag_content (create_collection, ingest_document). Skipped if the plan has no knowledge-base feature.

SKILL.md

2.0 KB, as published. Nobody here has run it

Journey: RAG

Stage 3g of the guided journey. Create RAG collections and ingest initial documents.

When to use

Dispatched by journey when current_stage: rag.
Directly via /butterbase-skills:journey-rag.
Skipped (annotated (n/a)) if the plan has no RAG section.

Preflight

If docs/butterbase/03-preflight.md is missing, older than 24 hours, or 00-state.md has app_id: null, invoke butterbase-skills:journey-preflight first. Wait for it to return successfully before proceeding.

Inputs

docs/butterbase/02-plan.md — the RAG section.
docs/butterbase/00-state.md — for app_id.

Procedure

Refresh docs. Call butterbase_docs with topic: "rag". For ingestion + retrieval patterns, also WebFetch https://docs.butterbase.ai/ai/rag. Skip if cache is fresh.
Read the RAG section. Print it back: "About to set up RAG: collections=<list>. Proceed?". Wait for yes.
Invoke butterbase-skills:rag-dev via the Skill tool with the RAG plan and app_id. The wrapped skill calls manage_rag_content action: create_collection, then ingest_document for any seed sources the user provides.
Smoke: call rag_query with a representative question and show the user the top hit.
Append one line to docs/butterbase/04-build-log.md: <ISO timestamp> rag manage_rag_content ok
Tick - [x] rag in 00-state.md, set current_stage: to the next unchecked stage.
Return to journey orchestrator (or ask "Continue to the next stage? (yes/no)").

Outputs

Created RAG collections, ingested seed docs.
One line in 04-build-log.md.

Anti-patterns

❌ Ingesting huge document sets in a single call — chunk and poll get_document_status.
❌ Skipping the smoke rag_query — silent embedding failures are common.