Skip to main content

​
What are Agent Skills?

Agent skills are self-contained capabilities that allow Karen agents to interact with the Solana blockchain. Each skill represents a specific action—like checking balances, swapping tokens, or staking SOL—that an agent can invoke during its decision-making cycle.

​
Architecture

The skill system is built on three core components:

​
1. Skill Registry

The SkillRegistry maintains all available skills and provides:
  • Skill registration and lookup
  • Conversion to LLM tool definitions
  • Centralized skill execution with error handling

​
2. Skill Context

Each skill execution receives a context containing:
  • Wallet Manager: Access to wallet keypairs and balances
  • Transaction Engine: Guardrail-protected transaction submission
  • Protocol Adapters: Jupiter (DEX), SPL Token, Staking, Token Launcher, Wrapped SOL

​
3. Individual Skills

Each skill is a TypeScript object implementing: 
interface Skill {
  name: string
  description: string
  parameters: Record<string, any>  // JSON schema
  execute(params, context): Promise<string>
}

​
Skill Invocation Rules

Agents must follow these critical rules when using skills:
ONE skill per cycle — Agents can only invoke a single skill per decision loop. Plan carefully.
Always include reasoning — Explain why you’re choosing this skill and these parameters.
Check balance first — Before making swaps or transfers, use check_balance to verify funds.
Respect spending limits — All transactions pass through guardrails. Exceeding limits will block the transaction.
When unsure, use wait — It’s better to skip a cycle than make a bad trade or transaction.

​
Available Skills (17 Total)

Karen agents have access to 17 distinct skills across four categories:

Wallet Operations

Basic wallet management: balances, transfers, airdrops, and waiting

DeFi Operations

Token swaps via Jupiter, token info lookup, and SOL wrapping

Token Management

Create, mint, burn, and manage SPL tokens

Staking

Stake SOL to validators, unstake, and manage delegations

​
Complete Skill List

Wallet Operations:
  • check_balance — View SOL and SPL token balances
  • transfer — Send SOL to another address
  • airdrop — Request devnet SOL from faucet
  • wait — Skip this cycle with reasoning
DeFi Operations:
  • swap — Exchange tokens via Jupiter DEX
  • token_info — Look up token metadata
  • wrap_sol — Convert SOL to wSOL
  • unwrap_sol — Convert wSOL back to SOL
Token Management:
  • launch_token — Create a new SPL token
  • mint_supply — Mint additional tokens
  • revoke_mint_authority — Permanently disable minting
  • burn_tokens — Destroy tokens
  • close_token_account — Reclaim rent from empty accounts
Staking Operations:
  • stake_sol — Delegate SOL to a validator
  • unstake_sol — Deactivate a stake account
  • withdraw_stake — Withdraw from deactivated stake
  • list_stakes — View all stake accounts

​
JSON Skill Invocation Format

Agents invoke skills using structured JSON: 
{
  "skill": "skill_name",
  "params": {
    "param1": "value1",
    "param2": 123
  }
}

​
Example: Checking Balance

{
  "skill": "check_balance",
  "params": {}
}

​
Example: Swapping Tokens

{
  "skill": "swap",
  "params": {
    "inputToken": "SOL",
    "outputToken": "USDC",
    "amount": 0.5,
    "slippageBps": 50
  }
}

​
Example: Waiting

{
  "skill": "wait",
  "params": {
    "reason": "Waiting for token price to stabilize before executing swap"
  }
}

​
Security Guardrails

All skills that execute transactions pass through Karen’s guardrail system:
GuardrailDefaultDescription
maxSolPerTransaction2 SOLMaximum SOL per single transaction
maxTransactionsPerMinute5Rate limiting for all transactions
dailySpendingLimitSol10 SOLTotal daily spending cap
allowedProgramsSystem, Token, JupiterOnly whitelisted programs allowed
Transactions that violate guardrails are immediately blocked and logged with status blocked.

​
Next Steps

Wallet Operations

Learn about balance checks, transfers, and airdrops

DeFi Operations

Explore token swaps and Jupiter integration

Token Management

Create and manage your own SPL tokens

Staking

Stake SOL and earn rewards from validators

Build docs developers (and LLMs) love

Get started for freeTalk to us