Welcome
Skillful AI is a platform for building production AI agents, deploying them across every channel your customers use (phone, email, chat, social), and optionally monetizing them through a marketplace with token-based pricing and governance.
This guide covers every surface you can reach inside the product today. Each section walks through what the screen shows, the steps you take, and any prerequisites.
Your first agent in 5 steps
The shortest path from zero to a working agent:
- Sign in. You land in the Agents Hub.
- Create an agent. Click Create New Agent → the AI Builder opens.
- Fill the essentials. On the Agent Info tab give the agent a name and short description. Switch to Strategy and pick React (a sensible default). Pick any listed LLM. Pick a built-in Character.
- Save. Your agent is now in Drafts.
- Chat. Open your agent from the Agents Hub → Chat. You're talking to your first agent.
Core concepts
A short mental model. You'll see these words across the product.
| Concept | What it is |
|---|---|
| Agent | A configured assistant: an LLM + a personality + skills + memory + a reasoning strategy. Lives in your Agents Hub. |
| Strategy | Basic = single-shot completion. React = reasons step-by-step and calls tools. Planning = plans then executes multi-step tasks. Strategy choice constrains which LLMs are available. |
| Skill | A capability the agent can invoke during a conversation (web search, calculators, piece integrations, your own flows). |
| Piece | A pre-built integration with a third-party app (Slack, Stripe, Google Drive, OpenAI, etc.). Pieces power both skills and flows. |
| Connection | An authorized credential for a piece. You authorize once, reuse everywhere. |
| Flow | A visual, multi-step workflow built from pieces. Triggered on a schedule, by a webhook, or called by an agent as a skill. |
| Channel | A place your agent lives: WhatsApp, Telegram, Instagram, Discord, Slack, Email, SMS/voice phone numbers, web chat. |
| Marketplace | The public storefront where agents can be published and subscribed to. |
| Stake | On-chain SKAI token staking on Ethereum or Base, tied to governance and rewards. |
Building agents
The AI Builder (/ai-builder) is where you configure an agent. The interface is organized into tabs you can work through in any order — but top-down is the recommended sequence.
4.1 Agent Info
Name, description, avatar. Drafts auto-save to your browser — if you close the tab you can recover where you left off.
4.2 Strategy
Pick the reasoning mode:
- Basic — fastest, cheapest, no tool calling
- React — reasons, chooses a tool, observes, loops. Good default.
- Planning — writes a plan first, then executes
- Other specialized strategies are available depending on your plan.
Your strategy choice filters which LLMs you can pick in the next step.
4.3 LLM
Choose a language model. Each option shows its context length. Providers typically include OpenAI, Anthropic, Google, and others. The list changes based on your selected Strategy.
4.4 Character
Pick a built-in personality template (Customer Service, Coaching, Influencer, others) or create a custom one — a dialog captures name, description, system prompt, and optional avatar.
4.5 Skills
Add tools the agent can call. Add Skill → browse the list → select. Some skills require an API key or a connection you authorized in /connections.
4.6 Pieces
Attach piece-based actions (Slack send message, Stripe create charge, Google Drive upload, etc.). Per piece, pick the exact actions the agent can use and select a Connection you've authorized.
4.7 Flows
Attach your own Skillful Flows as agent skills. The agent can trigger them mid-conversation. Only flows you've created are selectable.
4.8 Memory
- Upload files (PDF, CSV, text)
- Set how many results to retrieve per query (higher = more context, more tokens)
4.9 Media Processing (voice & audio)
Optional. Enable voice input and output:
- Pick a text-to-speech model
- Pick a voice ID
- Set a greeting message and default audio settings
4.10 Training
Add labeled examples — “when a user says X, respond like Y” — to fine-tune behavior beyond what the system prompt alone can do.
4.11 Monetization
- Free — anyone can use it
- Fixed USD price — charged via Stripe on subscribe
- Token-gated — gated by SKAI holdings on Solana, with fixed or USD-equivalent pricing
Publishing to the public Marketplace is triggered from this tab once configuration is complete.
4.12 Token
Optional. Mint or assign an agent-branded token (Pump.fun or custom). Set supply and manage holdings used for token-gating. Requires a connected wallet.
4.13 Versions
Every save creates a version. Tag versions, compare configurations, and roll back.
4.14 Agent Analytics (for this specific agent)
Per-agent usage, token consumption, cost, and latency — filterable by 7 / 30 / 90 day windows.
Connections
Before an agent or flow can use an integration, you must authorize it once at /connections.
Adding a connection
- Click New Connection
- Pick the piece (Slack, Stripe, Google Drive, OpenAI, etc.)
- Give this connection a name (useful if you have multiple Slack workspaces)
- Click Connect — this opens the third-party OAuth flow
- Approve → you are returned to Skillful with the connection stored
Managing connections
The connections table shows app, status, connection name, and last sync. Click a row to Rename, Delete, or Test.
Flows
Flows (/flows) are visual, multi-step automations built from pieces. The workhorse for non-conversational work: scheduled jobs, webhooks, data sync, bulk actions.
Browsing your flows
- Folders in the left sidebar — organize by project or team. Drag flows between folders.
- Flows table — name, status (enabled / disabled), last edited, creator, integrations used. Paginated 20 per page.
- Bulk actions — enable/disable selected, export, import.
- Search & filters — by name, by status, by connection type.
Creating a flow
- Click Create Flow → the visual builder opens (canvas, drag-and-drop pieces)
- Add a trigger (schedule, webhook, or an event from a piece)
- Chain actions (also from pieces) — each needs an authorized connection
- Test the flow with sample inputs
- Enable when ready
Viewing runs
The Runs tab shows execution history: filter by success or failed, drill into a run for step logs and error details.
Flows as agent skills
Once a flow exists, it becomes selectable on the Flows tab in the AI Builder, where you can attach it as a skill to any agent.
AI Channels
AI Channels (/ai-channels) is the unified inbox where conversations, contacts, deals, and channel configuration live in one place.
Conversations tab (default)
Split view: chat list on the left, thread on the right.
- Sub-tabs for each channel — WhatsApp, Telegram, Instagram, Discord, Slack, Email, OnlyFans, and others connected
- Filters — assigned-to-me, sort by recent or priority
- Thread actions — send text or media, record voice, attach files, use AI-suggested responses
- Conversation tools — message feedback, AI summaries, follow-up scheduling, labels and tags for routing
Contacts tab
A sorted list of every participant across your channels.
- Click a contact → conversation history, CRM-synced profile info, AI-generated profile summary
- Create manually or bulk-import via CSV
- Notes, tags, and deal associations
- Quick actions: message, schedule follow-up, view analytics
Deals tab
A pipeline view — drag deal cards across stages (prospecting → negotiation → closed, etc.). Click a deal for linked contacts, conversation history, and custom fields.
Channels tab
- See active phone numbers and channels
- Purchase a phone number through a checkout flow
- Routing — assign incoming messages on each channel to a specific agent or team
- Per-channel analytics: message volume, response rate
Content Library
Reusable response templates. Create, edit, search, and insert into any conversation with one click.
Analytics (inside AI Channels)
Overview of conversation metrics across channels. For deep analytics, see Analytics.
Contact Sync
Contact Sync (/contact-sync) pulls contacts from external CRMs into your Contacts tab so your agents have context on who they're talking to.
Adding a sync
- Add Sync → choose source (HubSpot, Salesforce, Google Contacts, Slack channels, etc.)
- Authenticate via OAuth
- Map fields — name, email, phone, custom fields
- Set a sync interval (hourly or daily)
- Confirm
Managing syncs
The Active Syncs table shows source, last sync time, contact count, status, and actions (pause, resume, delete). Synced contacts appear automatically in AI Channels → Contacts.
Image Hub
Image Hub (/image-hub) is an AI image studio with two modes.
Create mode
- Write a text prompt (long-form supported)
- Pick a model (OpenAI GPT Image, Flux Dev, etc.)
- (Flux only) Adjust advanced settings — dimensions, steps, guidance, prompt upsampling, output format
- Click Generate
Generated images can be downloaded, regenerated, or used as the seed for a prompt variation.
Edit mode
- Upload an image or pick one from your history
- Use the mask canvas to draw / erase the area you want to change (adjustable brush size)
- Enter an inpainting prompt
- Pick a model (OpenAI Inpaint, Flux Fill)
- Click Edit
Undo / redo is supported.
Collections
Saved images, organized into folders. Turn on auto-save to keep everything you generate.
Agents Hub
Agents Hub (/agents-hub) is your personal agent library.
| Tab | Shows |
|---|---|
| All Agents | Every agent on the platform you can access |
| My Agents | Agents you created — star/favorite available |
| Drafts | Unpublished agents — Continue Editing or Delete |
| Subscribed | Paid agents you have access to, with expiry and subscription management |
| Analytics | Cross-agent summary — see Analytics |
Per-card actions: Open (chat), Edit (if you own it), View Details, Subscribe / Unsubscribe, Share. Create New Agent routes to the AI Builder.
Marketplace
Marketplace (/marketplace) is the public storefront.
Browsing
- Featured — curated agents at the top
- Trending — popular by subscriptions and usage
- Browse All — search by name or description, filter by category (Customer Service, Education, Coaching, Art & Design, Marketing, Health, Fitness, Development, Dating, others) and by tag
Subscribing
Click an agent card → modal shows creator, description, rating, subscriber count, and pricing (free, USD, or SKAI tokens). Actions: Subscribe, View Agent (opens chat), or Buy.
Publishing your own
In the AI Builder's Monetization tab, configure pricing and publish. After publishing, the agent appears in the Marketplace. Creator revenue from subscriptions and purchases flows back to your account, net of platform fees.
Chat
/chat/agent/[agentId] is where a user actually talks to an agent.
- Header — agent name, avatar, info button (shows agent config snapshot)
- Input — text, media upload (images, documents, audio), voice recording, microphone for speech-to-text
- Suggested responses — AI-generated continuations appear under the input
- Streaming — responses render token-by-token
- File preview — uploaded images and PDFs appear inline
- Voice mode — available if the agent has Media Processing configured
- Memory — chats persist across sessions when you are logged in
New chats start empty; existing chats are resumed via a URL parameter.
Analytics
Two places to look.
Per-agent: AI Builder → Analytics tab
One specific agent: requests, tokens, cost, latency, strategy breakdown, 7 / 30 / 90 day windows.
Cross-agent: /agent-analytics
All your agents at once:
- Summary — total requests, avg response time, error rate, monthly cost
- Token Usage — per agent and per model, input vs output
- Cost Analysis — by model, agent, or integration
- Latency Distribution — histogram by strategy
- Strategy Breakdown — share of requests by reasoning mode
- Agent Comparison — side-by-side metrics
A refresh button is available; data updates automatically every few minutes.
Token economy
Stake (/stake)
- Connect your wallet — Thirdweb connect embed supports Ethereum and Base
- Pick the chain — the dashboard data updates per chain
- Use the Staking Calculator — enter an amount to see estimated APY, max lockup, and rewards timeline
- Stake — approve the token → enter amount → confirm → wait for blockchain confirmation
- Withdraw — pick a deposit in the Staked Deposits table → confirm → execute on-chain
A price chart (7 / 30 / 90 days) and a Legacy Staking table (archived positions) are also on this page.
Profile (/profile)
Your wallet and revenue dashboard.
- Profile card — avatar, shortened address, copy-to-clipboard, QR code
- Balance — native token balance with USD equivalent
- Assets Owned — paginated list of your token holdings
- Assets History — sent / received / staked / unstaked transactions, each linked to a block explorer
- Revenue chart — creator earnings from marketplace subscriptions
- Export — download history as CSV
Account & organization
Everything under /account controls your user, your keys, your billing, and your org.
API Keys (/api-keys)
List of your keys with name, last-used, and creation date. Create a key → it's shown once — copy it immediately. Revoke or toggle keys active / inactive.
Billing (/billing)
- Subscription tab — current plan, renewal date, card on file, change plan
- Crypto Deposits tab — prepay in USDC, USDT, or other supported tokens
- Transactions table — every charge (message fees, subscriptions, agent slots, marketplace purchases), sortable by date / type / amount
- Add Funds — card or crypto
Organization (/organization)
- Org name and logo
- Members — roster with roles (Owner, Admin, Developer, Member, Viewer). Invite via email; remove or change roles.
- Invitations — pending invites; resend or revoke
- Settings — transfer ownership, delete the org (Owner only)
Teams (/teams)
Create teams within the org, assign members, and scope permissions to specific agents or flows.
Permissions (/permissions)
Role-based access control. Define what each role can do — create agents, delete agents, manage billing, invite members — using presets or custom rules.
Prerequisites & gotchas
A short list of things that trip people up.
/connections./flows first, then it shows up in the AI Builder's Flows tab./contact-sync — you need at least one active sync (or manual / CSV imports) for contacts to populate.Glossary
A compact list lives here. For the full expanded entries with cross-links, see the dedicated glossary page.
- Agent
- A configured AI assistant (LLM + personality + skills + memory + strategy).
- Agents Hub
- Your personal library of agents (owned, drafts, subscribed).
- AI Builder
- The studio where you configure an agent.
- AI Channels
- The unified inbox for all conversational channels.
- Channel
- A place an agent lives (WhatsApp, Telegram, Email, phone, web chat, etc.).
- Character
- The personality template or custom prompt your agent uses.
- Connection
- An authorized credential for a piece.
- Draft
- An unpublished in-progress agent.
- Flow
- A visual, multi-step automation.
- Image Hub
- The AI image generation and editing studio.
- LLM
- The large language model your agent uses.
- Marketplace
- The public storefront for agents.
- Memory
- The knowledge base uploaded to an agent.
- Monetization
- How an agent earns (free, fixed USD, token-gated).
- Piece
- A pre-built integration with a third-party app.
- Skill
- A tool an agent can call during a conversation.
- Social Hub
- The dashboard for managing social-media agents.
- Stake
- SKAI token staking on Ethereum or Base.
- Strategy
- The reasoning mode (Basic, React, Planning, etc.).
- Subscription
- A recurring payment for access to a paid agent.
- Token
- The platform SKAI token, or an agent-branded token minted via Pump.fun or custom.
- Version
- A saved snapshot of an agent’s configuration.
Quick answers
Short answers to the questions we see most often. The full walkthrough for each lives in the sections above.
Social Hub
Social Hub (
/social-hub) is a dedicated dashboard for social-media agents.