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

# Plugins

> Install the allium-analyst plugin to give your agent a query methodology for Allium data.

## Skills and plugins

* A **skill** is a packaged set of instructions that an agent loads when a task matches it, on top of whatever tools it already has. Skills follow the open [Agent Skills specification](https://agentskills.io/specification).
* A **plugin** is an installable bundle of skills for Claude Code, registered through a [marketplace](https://code.claude.com/docs/en/plugin-marketplaces) so a single command installs the whole set.

Allium ships two plugins from the [`allium-labs/skills`](https://github.com/allium-labs/skills) repo: **`allium-agent`** (direct data access via the `allium` CLI and partner infrastructure skills) and **`allium-analyst`** (the analyst methodology covered on this page). Install either one on its own.

## The `allium-analyst` plugin

<CardGroup cols={2}>
  <Card title="Match the right source" icon="magnifying-glass">
    Your agent compares candidate tables, dashboards, and endpoints against the question before writing SQL.
  </Card>

  <Card title="Build the query and check it" icon="flask">
    It checks Allium Terminal for existing coverage, builds from a small test query to a production one, and validates the numbers.
  </Card>

  <Card title="Sector-specific pitfalls" icon="triangle-exclamation">
    It checks for the known double-counting, classification, and aggregation mistakes in RWA, stablecoins, bridges, DEX, and lending.
  </Card>

  <Card title="Reproducible results" icon="rotate">
    It saves load-bearing queries to Explorer so anyone can rerun them.
  </Card>
</CardGroup>

## Installation

<Note>
  You need the Allium MCP already configured before installing this plugin. See the [Quick start](/ai/mcp/overview#quick-start) if you haven't set that up yet.
</Note>

<Steps>
  <Step title="Add the Allium Labs marketplace">
    In Claude Code, run:

    ```
    /plugin marketplace add allium-labs/skills
    ```
  </Step>

  <Step title="Install the plugin">
    ```
    /plugin install allium-analyst@allium-labs
    ```
  </Step>

  <Step title="Restart Claude Code">
    Restart so the new skills load.
  </Step>

  <Step title="Try it">
    Ask something that needs the workflow, for example:

    > Use the Allium skills to investigate how tokenized RWA treasury supply has grown over the past 6 months, and save the query so I can share it.

    It's wired up correctly if your agent checks Terminal for existing coverage and hands you back a saved Explorer query at the end.
  </Step>
</Steps>

<Accordion title="Using a different MCP client, or want individual skills?">
  If you're not on Claude Code, or want specific skills without the plugin system, use the [Agent Skills](https://agentskills.io/) installer:

  ```bash theme={null}
  npx skills add allium-labs/skills --yes
  ```

  Add `--skill <name>` (for example `--skill data-matching`) to install one skill. Without it you get every skill in the repo.
</Accordion>

## Skills reference

`data-matching` and `allium-investigation` are the workflow skills. The rest are sector skills. Your agent loads one once the question touches that sector, and it plugs into the workflow at the source-selection step.

| Skill | Covers |
| - | - |
| `data-matching` | Picking the right table, metric, dashboard, or realtime endpoint |
| `allium-investigation` | Checking coverage, building the query, validating it, and saving it to Explorer |
| `rwa-analysis` | Tokenized real-world assets: treasuries, money market funds, tokenized equities |
| `stablecoin-analysis` | Stablecoin transfer volume, supply, holders, and geographic usage |
| `bridge-analysis` | Cross-chain bridge and messaging-protocol data (CCTP, LayerZero, Wormhole, Across) |
| `dex-analysis` | DEX/AMM trades, liquidity, aggregator routing, and DEX-derived pricing |
| `lending-analysis` | DeFi lending deposits, borrows, liquidations, and utilization |

<AccordionGroup>
  <Accordion title="data-matching" icon="magnifying-glass">
    It defines a data contract for the question (object, measure, grain, scope, and time semantics), compares candidate sources against that contract, and proves coverage with a bounded test query: a chain or table that appears in search may hold no real data. It runs first, before `allium-investigation` and any sector skill.
  </Accordion>

  <Accordion title="allium-investigation" icon="flask">
    It runs the investigation on the source `data-matching` picked. It checks Allium Terminal for existing coverage, builds the query from a small ephemeral test into a saved production query, and validates the result: reconciliation, duplicate-count checks, and cross-checking at least one figure a different way. It labels each finding as observed fact, interpretation, or unknown. At the end it saves load-bearing queries to Explorer, and when the investigation produced several queries it offers a dashboard hand-off to Allium Assistant.
  </Accordion>

  <Accordion title="rwa-analysis" icon="building-columns">
    It covers treasuries, money market funds, tokenized equities, commodities, and private credit. It treats AUM and supply as a snapshot and never sums them across days, aggregates multi-chain fund deployments and discloses the aggregation, classifies by underlying risk factor and not by legal wrapper, and excludes known bad-data tokens before ranking holders.
  </Accordion>

  <Accordion title="stablecoin-analysis" icon="dollar-sign">
    It covers USDC, USDT, DAI, and other issuers. It separates raw volume from adjusted volume, where raw can overstate activity by 5 to 20 times, handles chain-specific double-counting such as XRPL's trust-line rippling and Aptos's dual token addresses, and applies the address case-sensitivity rules, which vary by chain.
  </Accordion>

  <Accordion title="bridge-analysis" icon="bridge">
    It covers CCTP, LayerZero, Wormhole, Across, and canonical or application bridges. It explains the asymmetric, single-directional way transfers are recorded, the double-counting that shows up when you filter to two or more target chains at once, and how to trace a lock-and-mint transfer across chains when no direct join key links the two legs.
  </Accordion>

  <Accordion title="dex-analysis" icon="arrows-retweet">
    It covers Uniswap, PancakeSwap, Pump.fun, Orca, Pendle, aggregators, and perp DEXs like Hyperliquid. It explains per-hop double-counting on multi-hop routes, when to group by protocol and when to group by project, and how to reconstruct an aggregator's implicit fee when it arrives as a plain transfer with no labeled column.
  </Accordion>

  <Accordion title="lending-analysis" icon="hand-holding-dollar">
    It covers Aave, Morpho, Fluid, Euler, Maple, and their forks. Deposits, withdrawals, loans, repayments, and liquidations live in separate event tables, so it joins them to detect operations with no dedicated label, such as collateral swaps and deleveraging. It also handles the column-naming inconsistencies across those tables and fill-level double-counting on liquidations.
  </Accordion>
</AccordionGroup>

## Related resources

<CardGroup cols={2}>
  <Card title="MCP Overview" icon="plug" href="/ai/mcp/overview">
    Set up the Allium MCP server itself
  </Card>

  <Card title="Tools Reference" icon="code" href="/ai/mcp/tools-reference/overview">
    Documentation for the MCP tools these skills call
  </Card>

  <Card title="allium-labs/skills" icon="github" href="https://github.com/allium-labs/skills">
    Skill source, README, and the allium-agent plugin
  </Card>

  <Card title="Examples" icon="book" href="/ai/mcp/examples">
    Things customers built with the MCP
  </Card>
</CardGroup>