Skip to main content
Skills provide domain knowledge and tool capabilities to agents. When you assign a skill to an agent, that agent gains access to the skill’s tools and context.

Built-in Tools

Skills can access 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

Creating Skills

Initialize a new skill:
flipside skills init my_skill
This creates a YAML configuration:
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
  ...

Deploying Skills

Push your skill to make it available:
flipside skills push my_skill.yaml

Skill Commands

CommandDescription
flipside skills listList all skills in your organization
flipside skills describe <name>Show skill details
flipside skills init <name>Create new skill YAML config
flipside skills push <file.yaml>Deploy or update a skill
flipside skills pull <name>Download skill config as YAML
flipside skills delete <name>Delete a skill

Assigning Skills to Agents

Reference skills in your agent YAML:
name: my_agent
kind: chat
skills:
  - sql-querying
  - defi-analysis
  - my_custom_skill
Or inject skills at runtime:
flipside agents run myorg/my_agent --message "Query" --skill sql-querying,data-viz

Visibility Levels

Skills support three visibility levels:
LevelDescription
privateOnly you can access
organizationAll members of your org can access
publicAnyone can access