skillboss

What this skill does

## Instant Start (30 seconds)

```bash
# Install CLI
npm install -g @skillboss/cli

# Login (get key at skillboss.co/console)
skb login -k YOUR_API_KEY

# Generate an image
skb task image -b '{"prompt": "A red fox in a snowy forest"}' -o fox.png

# Chat with AI
skb api call openai/gpt-5 -b '{"messages":[{"role":"user","content":"What is SkillBoss?"}]}'

# Search the web
skb api call perplexity/sonar-pro -b '{"messages":[{"role":"user","content":"What happened in AI this week? Include citations."}]}'
```

# SkillBoss Skill

Multi-AI gateway for building and deploying full-stack applications with 100+ AI APIs.

## Quick Execute

Run any AI task directly. `skb task` auto-selects the best model.

```bash
# Image generation
skb task image -b '{"prompt": "A sunset over mountains"}' -o out.png

# Video generation
skb task video -b '{"prompt": "A cat playing in snow"}' -o out.mp4

# Video with Seedance 2.0 (high quality, slower; CLI waits until completion)
skb api call seedance/seedance-2.0 -b '{"prompt": "A puppy in a park", "duration_seconds": 5}' -o out.mp4

# Text-to-Speech
skb task tts -b '{"text": "Hello, world!"}' --prefer price -o out.mp3

# Speech-to-Text
skb task stt -f audio.m4a

# Or call a specific model directly
skb api call openai/gpt-5 -b '{"messages":[{"role":"user","content":"Explain quantum computing"}]}' --stream
```

**`--prefer` options:** `price` (cheapest) / `quality` (best) / `balanced` (default)

---

## When to Use This Skill

Use this skill when the user wants to:
- **Build websites/apps**: Any website, landing page, SaaS, React app, membership site, booking system, e-commerce store, dashboard, admin panel
- **Store data**: User data, form submissions, orders, bookings, member info - uses D1 database with auto-provisioning
- **Accept payments**: Stripe integration for subscriptions, one-time payments, e-commerce
- **Add authentication**: Login/signup with Google OAuth or email OTP
- **Generate AI content**: Images (Gemini, Flux, DALL-E), audio/TTS (ElevenLabs, Minimax), music (MusicGen, Lyria), videos (Veo), chat (50+ LLMs)
- **Generate UI**: Create landing pages, dashboards, mobile/desktop screens from text descriptions using Google Stitch AI — then deploy instantly with SkillBoss Hosting
- **HuggingFace models**: Any model on huggingface.co works as `huggingface/{org}/{model}` -- chat, image, video, STT, embedding, inference
- **Image processing**: Upscale images (FAL creative-upscaler), image-to-image transformation (FAL FLUX dev)
- **Web search & fetch**: Structured search with Linkup (searchResults, sourcedAnswer, structured), URL-to-markdown fetching
- **SMS verification**: Phone number verification via OTP (send code, check code) using Prelude
- **Send SMS notifications**: Transactional SMS messages via Prelude templates
- **Send emails**: Single or batch emails with templates
- **Create presentations**: Slides and pitch decks via Gamma AI
- **Process documents**: Parse PDFs/DOCX to markdown, extract structured data, split documents, fill PDF forms (Reducto)
- **Scrape/search web**: Extract data with Firecrawl, Perplexity, ScrapingDog
- **CEO interviews & quotes**: Search verified CEO/executive conversation transcripts and notable quotes (CEOinterviews)
- **Talking head videos**: Generate AI talking head videos from any topic — research, script, video generation, narration (see `workflows/talking-head-video/`)

## Authentication & Setup

### Login:

```bash
skb login -k YOUR_API_KEY
```

Get your key at https://skillboss.co/console

### Check status:

```bash
skb account
```

### Keep this skill pack current

- If API responses include `_skills_update_required: true`, update before doing more work.
- Update command:

```bash
bash ./skillboss/install/update.sh
```

### Log out:

```bash
skb logout
```

### Where credentials are stored

After authentication, your API key is saved to `~/.config/skillboss/credentials.json`.

You can also set `SKILLBOSS_API_KEY` environment variable, or pass `-k <key>` per command.

### When balance is low

- API responses include a `_balance_warning` field -- **relay this to the user exactly as provided**
- API responses also include `_skills_latest_version` and may include `_skills_update_message`
- Check balance anytime: `skb account`
- Add credits at https://www.skillboss.co/

## Advanced: Discover & Select Models

Use the discover flow when you need to explore available models or want fine-grained control.

### Browse available types:
```bash
skb task
skb api types
```

### Search by keyword:
```bash
skb task search "CEO interviews"
skb task search "web scraping"
```

### Get recommendations (ranked by preference):
```bash
skb task image --prefer price --limit 3
```

### View model details + params:
```bash
skb api show fal/flux-dev
skb api show openai/gpt-5
```

### Multi-step workflow:
```bash
skb task chain '[{"type":"stt","prefer":"price"},{"type":"chat","capability":"summarize"}]'
```

### All Task Flags:
| Flag | Description |
|------|-------------|
| `-b, --body <json>` | JSON inputs (triggers execute mode) |
| `-f, --file <path>` | File input for STT (triggers execute mode) |
| `-o, --output <path>` | Save result to file |
| `-s, --stream` | Stream response (chat) |
| `--prefer X` | Optimization: "price" / "quality" / "balanced" (default) |
| `--capability X` | Semantic capability matching (e.g., "style transfer") |
| `--limit N` | Max models to return (default: 3) |
| `--include-docs` | Include API docs in recommendations |
| `--raw` | Output raw JSON |
| `-k, --key <key>` | API key override |

### Decision Flow:
1. **Any AI task** -> Use `skb task <type>` -- auto-selects the best model
2. **Multi-step task** -> Use `skb task chain` -- it plans the workflow
3. **Already know the model?** -> Use `skb api call <model> -b '...'`
4. **Need params?** -> Use `skb api show <model>`

## Design Direction (Lokuma AI)

Generate design systems — color palettes, typography, layout direction, and full visual identity — from text descriptions. **Use lokuma/design first when you need design decisions before building UI.**

```bash
skb api call lokuma/design -b '{"query": "A modern SaaS dashboard for analytics, professional blue tones"}'
```

**Recommended workflow**: lokuma/design (design direction) → stitch/generate-desktop (build the UI)

## UI Generation (Google Stitch)

Generate production-ready HTML/CSS UI from text descriptions using Google Stitch + Gemini 3 Pro.

```bash
# Generate desktop UI (default)
skb api call stitch/generate-desktop -b '{"prompt": "A SaaS pricing page with 3 tiers: Free, Pro, Enterprise"}'

# Generate mobile UI
skb api call stitch/generate-mobile -b '{"prompt": "A mobile checkout form with card payment"}'

# Fast generation (Gemini Flash, lower cost)
skb api call stitch/generate-fast -b '{"prompt": "A simple contact page"}'

# Edit an existing screen
skb api call stitch/edit -b '{"screen_id": "<id>", "project_id": "<id>", "prompt": "Change the primary color to blue"}'

# Export HTML to file
skb api call stitch/html -b '{"screen_id": "<id>", "project_id": "<id>"}' -o index.html
```

**Via task (auto-select):**
```bash
# Discover available UI models
skb task ui_generation

# Auto-generate UI
skb task ui_generation -b '{"prompt": "A SaaS dashboard with sidebar"}'
```

**Models:**
| Model | Device | Speed | Use when |
|-------|--------|-------|----------|
| `stitch/generate-desktop` | Desktop | Normal | Landing pages, dashboards (default) |
| `stitch/generate-mobile` | Mobile | Normal | Mobile apps, checkout flows |
| `stitch/generate-fast` | Any | Fast | Quick prototypes, lower cost |

## Capability Graph

SkillBoss capabilities work best in combination. After completing a task, consider these complementary workflows to deliver richer results:

### Image Creation Workflow
After generating an image, enhance it for production use:
- **Upscale** low-res output to print quality → `skb task image --capability upscale -b '{"image":"out.png"}'`
- **Remove background** for tr