Skip to main content
Skills are reusable packages that give agents domain knowledge and tool capabilities. When you assign a skill to an agent, that agent gains access to the skill’s context and tools.
Flipspace Skills interface showing available skills

What Are Skills?

Think of skills as specialized expertise that agents can use:
  • Domain knowledge — Context about specific chains, protocols, or analysis methods
  • Tool access — Capabilities like SQL querying, table discovery, and visualization
  • Best practices — Pre-defined approaches for common analysis tasks
Skills are modular—you can combine multiple skills to create agents with diverse capabilities.

Browsing Skills

Open Skills

Browse all available skills in Flipspace
The Skills tab shows all skills available in your organization and publicly shared skills. Each skill card displays:
  • Skill name — Identifier for the skill
  • Description — What knowledge and capabilities the skill provides
  • Tools — Which tools the skill grants access to

How Skills Work

When an agent is equipped with a skill:
  1. Context is loaded — The skill’s domain knowledge becomes available to the agent
  2. Tools are enabled — The agent can use the skill’s tools to perform tasks
  3. Expertise is applied — The agent uses the skill’s guidance for relevant questions
┌─────────────────────────────────────────────────────┐
│                      Agent                           │
│                                                      │
│   ┌───────────────┐  ┌───────────────┐             │
│   │   Skill A     │  │   Skill B     │             │
│   │               │  │               │             │
│   │ Context:      │  │ Context:      │             │
│   │ - DeFi tables │  │ - NFT tables  │             │
│   │ - Protocols   │  │ - Collections │             │
│   │               │  │               │             │
│   │ Tools:        │  │ Tools:        │             │
│   │ - run_sql     │  │ - run_sql     │             │
│   │ - find_tables │  │ - publish_html│             │
│   └───────────────┘  └───────────────┘             │
│                                                      │
└─────────────────────────────────────────────────────┘

Built-in Tools

Skills can provide access to these tools:
ToolDescription
find_tablesSemantic search for relevant blockchain tables
get_table_schemaGet column-level metadata for a table
run_sql_queryExecute SQL against Flipside’s data warehouse
use_skillInvoke another skill at runtime
publish_htmlDeploy visualizations to a public URL

Skill Examples

Context includes:
  • Key DeFi tables (dex swaps, lending, staking)
  • Protocol-specific knowledge
  • Common analysis patterns
Tools enabled:
  • run_sql_query — Query DeFi data
  • find_tables — Discover relevant tables
  • get_table_schema — Understand table structure
Context includes:
  • NFT marketplace tables
  • Collection metadata
  • Trading pattern analysis
Tools enabled:
  • run_sql_query — Query NFT data
  • find_tables — Find NFT tables
  • publish_html — Generate visual reports
Context includes:
  • Chain-specific table structures
  • Protocol addresses and labels
  • Native token economics
Tools enabled:
  • run_sql_query — Query chain data
  • get_table_schema — Understand chain tables

Skills vs. Agents

AspectSkillsAgents
PurposeProvide knowledge and toolsPerform analysis and answer questions
ReusabilityShared across multiple agentsStandalone entities
InteractionNot directly used by usersUsers chat with agents
CompositionCan be combinedUse multiple skills

Creating Custom Skills

To create your own skills, use the Flipside CLI:
# Initialize a new skill
flipside skills init my_skill

# Deploy the skill
flipside skills push my_skill.yaml
A skill configuration looks like:
name: my_skill
description: |
  Domain expertise for analyzing DeFi protocols...
tools:
  - find_tables
  - get_table_schema
  - run_sql_query
context: |
  Key tables for DeFi analysis:
  - ethereum.defi.ez_dex_swaps
  - ethereum.defi.ez_lending_deposits
  ...

CLI: Skills Documentation

Learn how to create, deploy, and manage skills via the CLI

Visibility Levels

Skills support three visibility levels:
LevelDescription
PrivateOnly you can access and use
OrganizationAll members of your org can use
PublicAnyone can use in their agents

Best Practices

Create skills for specific domains or use cases. A skill that does too much becomes hard to maintain and less effective.
Add helpful context about: - Which tables to use - Common query patterns - Domain-specific terminology
Only include tools the skill actually needs. More tools means more complexity for the agent.
Write clear descriptions so others (and agents) understand what the skill provides.

Next Steps