> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flipsidecrypto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> AI-powered assistants with specialized skills for blockchain intelligence

Agents are AI-powered assistants that combine blockchain data access, domain expertise, and
specialized tools to solve complex analysis problems. Each agent is equipped with **skills** that
define what it knows and what it can do.

<Frame>
  <img src="https://mintcdn.com/flipside-3887e776/2p0PEJQiT2mOBFkO/images/flipspace/flipspace-agents.png?fit=max&auto=format&n=2p0PEJQiT2mOBFkO&q=85&s=b9d70e7a0e36137629ff67a38b538914" alt="Flipspace Agents interface showing available agents with their skills and tools" width="1475" height="948" data-path="images/flipspace/flipspace-agents.png" />
</Frame>

## Key Concepts

<CardGroup cols={2}>
  <Card title="Agents" icon="robot" href="/flipspace/agents/agents">
    AI assistants that can query data, analyze patterns, and generate insights. Each agent has a
    specific purpose and is equipped with relevant skills.
  </Card>

  <Card title="Skills" icon="wand-magic-sparkles" href="/flipspace/agents/skills">
    Reusable packages of domain knowledge and tools. Skills give agents the context and capabilities
    they need to perform specific tasks.
  </Card>
</CardGroup>

## How Agents Work

Agents combine three key components:

1. **AI Model** — The underlying language model (Claude, GPT, etc.) that powers reasoning and
   conversation
2. **Skills** — Domain knowledge and tool access packaged for specific use cases
3. **Tools** — Capabilities like SQL querying, table discovery, and data visualization

When you chat with an agent, it uses its assigned skills to understand your question, query the
right data, and generate meaningful insights.

## Getting Started

Agents and skills are created and managed through the **Flipside CLI**. To build your own:

<Steps>
  <Step title="Install the CLI">
    Follow the [CLI installation guide](/flipspace/cli/installation) to set up the Flipside CLI on
    your machine.
  </Step>

  <Step title="Create an Agent">
    Use `flipside agents init` to create a new agent configuration. See the [CLI Agents
    documentation](/flipspace/cli/agents) for details.
  </Step>

  <Step title="Create Skills">
    Use `flipside skills init` to create skills that give your agent domain knowledge and tools. See
    the [CLI Skills documentation](/flipspace/cli/skills) for details.
  </Step>

  <Step title="Deploy">Push your agent and skills to make them available in Flipspace.</Step>
</Steps>

<CardGroup cols={3}>
  <Card title="Install CLI" icon="download" href="/flipspace/cli/installation">
    Get started with the Flipside CLI
  </Card>

  <Card title="CLI: Agents" icon="robot" href="/flipspace/cli/agents">
    Create and deploy agents
  </Card>

  <Card title="CLI: Skills" icon="wand-magic-sparkles" href="/flipspace/cli/skills">
    Create and deploy skills
  </Card>
</CardGroup>

## Agent Architecture

```
┌─────────────────────────────────────────────┐
│                   Agent                      │
│  ┌─────────────────────────────────────┐    │
│  │           AI Model                   │    │
│  │     (Claude, GPT, Gemini)           │    │
│  └─────────────────────────────────────┘    │
│                    │                         │
│  ┌─────────┬───────┴───────┬─────────┐     │
│  │ Skill 1 │    Skill 2    │ Skill 3 │     │
│  │         │               │         │     │
│  │ Tools:  │   Tools:      │ Tools:  │     │
│  │ - SQL   │   - Tables    │ - HTML  │     │
│  │ - Viz   │   - Schema    │ - SQL   │     │
│  └─────────┴───────────────┴─────────┘     │
└─────────────────────────────────────────────┘
```

## Learn More

<CardGroup cols={2}>
  <Card title="Agents" icon="robot" href="/flipspace/agents/agents">
    Browse and use AI agents
  </Card>

  <Card title="Skills" icon="wand-magic-sparkles" href="/flipspace/agents/skills">
    Understand agent skills
  </Card>

  <Card title="CLI: Agents" icon="terminal" href="/flipspace/cli/agents">
    Create agents via CLI
  </Card>

  <Card title="CLI: Skills" icon="terminal" href="/flipspace/cli/skills">
    Create skills via CLI
  </Card>
</CardGroup>
