shenseanchen/launch-agent-skills/rag-database
- community
Checking that the SKILL.md file is still in the repository.
Install
npx vskill@latest install shenseanchen/launch-agent-skills/rag-databaseSKILL.md
Directory: launch-agent-skills/skills/rag-database/skill.md
name: Supabase Database Setup description: Set up Supabase database for launch-rag or launch-agentic-rag using CLI automation or manual setup triggers:
- supabase
- database setup
- vector database
- pgvector
- postgres
- supabase setup
Supabase Database Setup Skill
Purpose
Set up a Supabase database for RAG applications using either:
- CLI Automation (recommended) - Fully automated via
supabaseCLI - Manual Setup - Web dashboard guided walkthrough
Works with both:
- launch-rag - Basic RAG
- launch-agentic-rag - Agentic RAG
Both repos use the identical SQL schema (rag_chunks table with pgvector, 1536 dimensions).
IMPORTANT: This skill should be used AFTER cloning/setting up your FastAPI project (use rag-setup skill first).
Instructions
Step 0: Choose Setup Method
Ask the user which method they prefer:
Option A: CLI Automation (faster, fully automated)
- Requires: Supabase CLI installed
- Check with:
which supabase - Install if needed:
brew install supabase/tap/supabase(macOS)
Option B: Manual Setup (web dashboard)
- No CLI required
- Step-by-step web interface
đ OPTION A: CLI Automation (Recommended)
Security Note for Demos/Tutorials
IMPORTANT: When setting up Supabase for live demos, YouTube tutorials, or presentations:
- â Use JSON output mode to parse values programmatically
- â Generate strong passwords without displaying them
- â Mask all sensitive outputs (API keys, passwords, tokens)
- â Show process, not secrets - display steps and confirmations, not actual values
- â Auto-update .env - write credentials directly to file without showing them
- â Confirm success with "â Credentials saved to .env" messages
Step 1: Check Requirements
If CLI is not installed:
Step 2: Login to Supabase
This will:
- Open your browser for authentication
- Save access token locally
- Allow CLI to manage your projects
For demos: The login only needs to happen once and won't expose credentials.
Step 3: Ask User for Project Details
Always ask the user for:
- Project name
- Suggest:
demo-agent-rag,youtube-rag-demo,agent-skills-demo, orrag-agent-test - For demos: Use names that clearly indicate it's for testing/demo purposes
- Database password handling
- For production: Ask user to provide their own strong password
- For demos/tutorials: Generate a strong random password automatically
- NEVER display the password - store it directly in
.env
- Region
- List options:
us-east-1,us-west-1,eu-west-1,ap-southeast-1, etc. - Default to user's closest region
- Organization
- Get via:
supabase orgs list --output json - Use the first org or ask user to select
Step 4: Generate Secure Password (for demos)
Step 5: Get or Create YouTube Organization
IMPORTANT:
- For demo/tutorial projects, always prefer the "YouTube" organization if it exists
- This keeps demo projects organized separately from production
- If "YouTube" org doesn't exist, use the first available or ask user to create one
Step 6: Create Project via CLI
Important:
- Use
--output jsonto get machine-readable output - Parse with
jqor Python for safety - Never echo sensitive values directly
- Wait for project to be ready (~2 minutes)
Step 7: Wait for Project Initialization
Step 8: Get API Keys (Securely)
IMPORTANT: The --output json flag for api-keys command may not work correctly in all Supabase CLI versions. Use the default table output and parse with awk/grep for reliability.
Step 9: Link Local Project
Step 10: Run SQL Initialization
Alternative migration approach:
Step 11: Auto-Update .env File (Secure)
Use Edit tool to update .env WITHOUT displaying sensitive values:
IMPORTANT for Claude Code:
- Use the
Edittool to modify.envfile - Replace placeholder values with actual credentials
- Do NOT echo or display the actual keys in output
- Confirm with generic success message
Step 11b: Configure AI Provider (Critical!)
After updating Supabase credentials, check and fix AI provider settings:
Key Points:
- â OpenAI key is REQUIRED - used for embeddings (text-embedding-3-small)
- â Default to AI_PROVIDER=openai unless user explicitly has Anthropic key
- â ī¸ Check for placeholder values and warn user to replace them
- â ī¸ Don't leave placeholder API keys - they cause runtime 401 errors
Step 12: Verify Setup
Step 13: Display Summary (Safe for Demos)
đ OPTION B: Manual Setup
Step 1: Check for SQL Initialization File
Expected: sql/init_supabase.sql
Step 2: Create Supabase Project (Manual)
Tell the user:
- Go to https://supabase.com
- Sign in or create an account
- Click "New Project"
- Fill in project details:
- Name: Choose a project name (e.g., "my-rag-agent")
- Database Password: Create a strong password (save it!)
- Region: Choose closest to you
- Pricing Plan: Free tier is sufficient for development
- Click "Create new project"
- Wait ~2 minutes for project to initialize
Step 3: Retrieve API Keys
Once the project is ready, guide the user to get their API keys:
Tell the user:
- In your Supabase dashboard, go to Settings (gear icon in sidebar)
- Click API in the settings menu
- Copy these three values (you'll need them for
.env):
- Project URL:
https://xxxxx.supabase.co - anon public key: Starts with
eyJ...(long string) - service_role secret key: Starts with
eyJ...(different long string)
Important: Keep the service_role key SECRET - it has full database access!
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/rag-database/skill.md
Popularity
- Repository stars
- 8
- Repository forks
- 2
- 7-day trend score
- 11
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 25 Mar 2026, 7 months ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/shenseanchen/launch-agent-skills/rag-database)