ai-setup
Configure AI model options - budget cloud models (save 80%+) and offline mode (use Dex without internet)
npx skills add majiayu000/claude-skill-registry --skill ai-setup --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
What it does
Configures multiple AI model options for Dex: Budget Cloud for online cost savings, Offline Mode to run local models without internet, and Smart Routing to auto-select the best model per task.
How it works
- Provides an Entry Point and branchable flow triggered by /ai-setup, onboarding, or cost/offline inquiries.
- Branch 2 (Offline) guides system checks, RAM-based model recommendation, Ollama installation, model download, and local execution configuration, updating models.json and user-profile to enable offline usage.
- Branch 1 (Budget Cloud) guides payment readiness with OpenRouter, presents budget model options (Kimi K2.5, DeepSeek V3, Gemini Flash), and creates a models.json with these providers, plus steps to supply an OpenRouter API key, then updates the user profile to enable budget cloud.
- Branch 2.1 to 2.7 include system checks, model installation and testing, and profile updates for offline configuration.
- Branch 3 (Smart Routing) inspects existing configurations, describes routing rules depending on configured options, and updates system profile with routing rules to map task types to models. It supports multiple setup states (budget, offline, both, or neither) and adapts the guidance accordingly.
When to use it
- Triggered when a user types /ai-setup, during onboarding, or when asked about reducing costs or offline work.
- Use to offer a path that emphasizes cost savings, offline capability, and automatic model selection depending on what is configured.
What it can touch
- Updates to System/user-profile.yaml to enable ai_models configurations (budget_cloud, offline, smart_routing).
- Writes to ~/.pi/agent/models.json to register budget and offline models with OpenRouter and Ollama (offline).
- References external services and local installations (OpenRouter, Ollama) as part of setup.
Caveats
- Requires external account setup (OpenRouter) and possibly hardware with sufficient RAM for offline models.
- Uses potentially non-Claude models (Kimi, DeepSeek, Gemini Flash, Qwen) and notes quality trade-offs.
- Steps include sensitive actions like API keys and paid credits; ensure user intent and payment readiness before proceeding.
## Purpose Help users configure alternative AI models for Dex: 1. **Budget Cloud** - Cheaper models like Kimi, DeepSeek (80-97% savings) 2. **Offline Mode** - Local models via Ollama (works without internet) 3. **Smart Routing** - Automatically pick the best model per task This skill is designed for users of ALL technical levels. Use plain language, avoid jargon, and guide step-by-step. ## When to Run - User types `/ai-setup` - Mentioned during onboarding (optional advanced setup) - User asks about reducing AI costs - User asks about working offline - User is traveling frequently --- ## Entry Point Say: ``` **Let's configure your AI options!** Right now, Dex uses Claude for everything. It's excellent, but it costs money per use and requires internet. Here are your options: --- **1. 💰 Budget Cloud Mode** — Cheaper AI when online **What it is:** Use models like Kimi or DeepSeek that cost 80-97% less than Claude **The catch:** Requires a small upfront payment (~$5-10) to a service called OpenRouter - You'll need a credit card or Apple Pay - That $5-10 lasts weeks or months - Example: If Claude costs you $90/month, this would cost ~$10-20/month **Best for:** People who use Dex heavily
- Purpose
- When to Run
- Entry Point
- If User Chooses "Both"
- Graceful Pivots
- Branch 1: Budget Cloud Setup
- Step 1.0: Confirm They're Ready to Pay
- Step 1.1: Explain the Options (Plain Language)
- Step 1.2: OpenRouter Setup (The Key Step)
- Step 1.3: Configure the Key
- Step 1.4: Update User Profile
- Branch 2: Offline Mode Setup
- Step 2.1: Check System Requirements
- Step 2.2: Recommend Model Based on RAM
which ollama || echo "not installed"
What does the ai-setup skill do?
Configure AI model options - budget cloud models (save 80%+) and offline mode (use Dex without internet)
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill ai-setup --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.