SkillBoss Skill

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

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

Authentication & Setup

No API key? Get a free trial instantly:

./scripts/skillboss auth trial

Provisions a trial API key with $0.25 free credit. No browser, no sign-up required. The key is saved automatically and printed to stdout.

If trial provisioning is rate-limited:

If auth trial returns a rate-limit error, ask the user:

Trial provisioning is rate-limited. Would you like to sign up for a SkillBoss account instead? https://www.skillboss.co (yes/no)

If yes, run ./scripts/skillboss auth login.

Upgrade to a permanent account:

./scripts/skillboss auth login

Opens your browser to sign up or log in at skillboss.co. Trial credits transfer to the permanent account automatically.

Check status and balance:

./scripts/skillboss auth status

Log out:

./scripts/skillboss auth logout

Where credentials are stored

After authentication, your API key is saved to:

Location	Path
Global credentials	`~/.config/skillboss/credentials.json`
Skill config	`config.json` in the skill directory

Resolution order: ~/.config/skillboss/credentials.json > config.json

When balance is low

API responses include a _balance_warning field -- relay this to the user exactly as provided
Check balance anytime: ./scripts/skillboss auth status
Add credits at https://www.skillboss.co/
Trial users (sk-tmp- keys) can upgrade to a permanent account: ./scripts/skillboss auth login

Post-First-Request Signup Prompt

Only for temp/trial keys (keys starting with sk-tmp-): after the very first successful API request, ask the user and wait for their reply:

Would you like to sign up for a SkillBoss account https://www.skillboss.co? You'll get access to all features and more credits. (yes/no)

Skip this prompt entirely if the API key starts with sk- (without tmp). Permanent keys mean the user is already signed up.

IMPORTANT: Do NOT show a signup URL or run auth login yet. Wait for the user to reply yes or no.

If the user says yes:

Run:
```
./scripts/skillboss auth login
```
If the browser opens successfully, auth login handles the full flow (provision, browser, poll, bind).
If there is no browser (headless server, SSH, Docker), auth login will output a URL like:
```
Could not open browser. Open this URL manually:
  https://www.skillboss.co/login?temp=sk-tmp-...
```
Relay the full URL from the output directly to the user so they can open it on another device to sign up and bind their trial key.

If the user says no: Continue normally. Do not ask again in this session.

Auto-Update (MANDATORY)

CRITICAL: After EVERY API call, check the output for [skillboss] UPDATE REQUIRED. If you see this message:

Stop what you are doing
Run the update command immediately:
```
bash ./install/update.sh
```
(Windows: .\skillboss\install\update.ps1)
Then re-run your original command

This ensures you always have the latest models, features, and bug fixes. Never ignore the update message -- outdated versions may have deprecated models or missing features that cause failures.

You can also proactively check for updates at any time:

node ./scripts/api-hub.js version

How to Call Any AI Model (Start Here)

ALWAYS use the pilot command. It auto-selects the best model and uses the same CLI syntax as other commands.

Setup: Run ./scripts/skillboss auth trial to get an API key, or ./scripts/skillboss auth login to sign in. The key is saved automatically and used by all commands.

Step 1 -- Discover what's available:

node ./scripts/api-hub.js pilot --discover

Returns all available model types (chat, image, video, tts, stt, music, etc.).

Step 2 -- Search by keyword:

node ./scripts/api-hub.js pilot --discover --keyword "CEO"

Step 3 -- Get recommendations:

node ./scripts/api-hub.js pilot --type image --prefer price --limit 3

Returns ranked models with documentation.

Step 4 -- Execute (auto-select best model):

node ./scripts/api-hub.js pilot --type image --prompt "A sunset over mountains" --output sunset.png
node ./scripts/api-hub.js pilot --type chat --prompt "Explain quantum computing"
node ./scripts/api-hub.js pilot --type tts --text "Hello world" --output hello.mp3
node ./scripts/api-hub.js pilot --type stt --file recording.m4a
node ./scripts/api-hub.js pilot --type music --prompt "upbeat electronic" --duration 30 --output track.mp3
node ./scripts/api-hub.js pilot --type video --prompt "A cat playing" --output video.mp4

Multi-step workflow:

node ./scripts/api-hub.js pilot --chain '[{"type":"stt","prefer":"price"},{"type":"chat","capability":"summarize"}]'

Pilot Flags:

Flag	Description
`--discover`	Browse available types and models
`--keyword X`	Search models by keyword (with --discover)
`--type X`	Model type: chat, image, video, tts, stt, music, etc.
`--capability X`	Semantic capability matching (e.g., "style transfer")
`--prefer X`	Optimization: "price" / "quality" / "balanced" (default)
`--limit N`	Max models to return (default: 3)
`--prompt X`	Text prompt (triggers auto-execute)
`--text X`	Text input for TTS (triggers auto-execute)
`--file X`	Audio file for STT (triggers auto-execute)
`--output X`	Save result to file
`--duration N`	Duration in seconds (music, video)
`--voice-id X`	Voice ID for TTS
`--image X`	Image URL for video/image tasks
`--size X`	Image size
`--system X`	System prompt for chat
`--chain '[...]'`	Multi-step workflow definition

Decision Flow:

Any AI task -> Use pilot -- it auto-selects the best model
Multi-step task -> Use pilot --chain -- it plans the workflow
Already have a model ID from pilot recommendations? -> Use direct commands (see commands.md)

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 workflow guides
Model Reference	`reference.md`	Complete model list and detailed parameter docs