Instant Start (30 seconds)

# 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 deepseek-v3 -b '{"messages":[{"role":"user","content":"What is SkillBoss?"}]}'

# Search the web
skb api call linkup/search -b '{"query": "latest AI news"}'

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.

# 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, CLI auto-polls async models)
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 deepseek-v3 -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:

skb login -k YOUR_API_KEY

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

Check status:

skb account

Log out:

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
• 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:

skb task
skb api types

Search by keyword:

skb task search "CEO interviews"
skb task search "web scraping"

Get recommendations (ranked by preference):

skb task image --prefer price --limit 3

View model details + params:

skb api show flux-1.1-pro
skb api show deepseek-v3

Multi-step workflow:

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.

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.

# 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):

# 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 transparent PNGs → skb api call replicate/lucataco/remove-bg -b '{"image_url":"..."}'
• Style transfer to match a brand aesthetic → skb task image --capability img2img -b '{"image":"out.png","prompt":"..."}'
• Animate the image into a short video → skb task video --capability i2v -b '{"image":"out.png","prompt":"bring to life"}'

Video Production Workflow

Combine generation with audio for complete clips:

• Generate source image first, then animate → skb task image → skb task video --capability i2v
• Add narration with text-to-speech → skb task tts -b '{"text":"..."}'
• Add background music → skb task music -b '{"prompt":"upbeat background track"}'
• Transcribe existing audio for subtitles → skb task stt -f audio.m4a
• Talking head video — full workflow: research → script → AI video → narration → see workflows/talking-head-video/

Content & Marketing Workflow

Build complete campaigns from a single idea:

• Research the topic with AI search → skb api call perplexity/sonar-pro -b '{"messages":[...]}'
• Write copy with any LLM → skb api call deepseek-v3 -b '{"messages":[...]}'
• Generate hero images → skb task image -b '{"prompt":"..."}'
• Create presentation slides → skb api call gamma/generation -b '{"prompt":"..."}'
• Design a logo with Lokuma → skb api call lokuma/design -b '{"query":"..."}'

Web App Workflow

From design to deployed product:

• Design direction → skb api call lokuma/design -b '{"query":"..."}'
• Generate UI → skb api call stitch/generate-desktop -b '{"prompt":"..."}'
• Deploy to Cloudflare → skb task deploy
• Add payments via Stripe Connect → skb stripe-connect
• Add auth (Google OAuth / email OTP) → see workflows/login-integration/
• Send emails to users → skb api call send-email

Data & Research Workflow

Gather, process, and analyze information:

• Search the web → skb api call linkup/search -b '{"query":"..."}'
• Scrape pages for raw data → skb api call firecrawl/scrape -b '{"url":"..."}'
• Parse documents (PDF/DOCX) → skb api call reducto/parse
• Generate embeddings for RAG → skb api call openai/text-embedding-3-small
• Search CEO interviews for executive insights → skb api call ceointerviews/get_feed -b '{"keyword":"..."}'

Audio Production Workflow

Create podcasts, voiceovers, and soundtracks:

• Text-to-speech in 29 languages → skb task tts -b '{"text":"..."}'
• Generate music and sound effects → skb task music -b '{"prompt":"..."}'
• Transcribe recordings → skb task stt -f recording.m4a

Full capability list: 100+ AI models across chat, image, video, audio, search, scraping, deployment, payments, and more. Run skb task to explore all available types.

Topic References

Read these files for detailed documentation on specific topics:

Topic	File	When to Read
Commands	commands.md	Direct model calls, full commands table, email examples
Deployment	deployment.md	Static vs Worker deployment, e-commerce, Stripe, wrangler.toml
API Integration	api-integration.md	Embedding SkillBoss API in user code (TypeScript/JS examples)
Error Handling	error-handling.md	HTTP errors, retries, rate limits, balance warnings
Billing	billing.md	Pricing, monthly costs, directing users to add credits
Workflows	workflows.md	Logo, website, podcast, email, e-commerce, talking head video workflow guides
Model Reference	reference.md	Complete model list and detailed parameter docs