Skip to content

Plugins Overview

Plugins are the primary distribution mechanism for Uniswap AI tools. Each plugin is a self-contained package that provides skills and agents for Claude Code.

Available Plugins

PluginDescriptionSkills
uniswap-hooksSecurity-first Uniswap V4 hook developmentv4-security-foundations
uniswap-ccaCCA auction configuration and deploymentconfigurator, deployer
uniswap-tradingUniswap swap integrationswap-integration
uniswap-viemEVM blockchain integration with viem/wagmiviem-integration
uniswap-driverSwap and liquidity deep link planningswap-planner, liquidity-planner

Installation:

bash
/plugin marketplace add uniswap/uniswap-ai

Plugin Architecture

Structure

Each plugin follows this structure:

text
plugin-name/
├── .claude-plugin/
│   └── plugin.json        # Plugin manifest
├── skills/                 # AI skills
│   └── skill-name/
│       ├── SKILL.md       # Skill definition
│       └── references/    # Supporting materials
├── agents/                 # Specialized agents (optional)
├── package.json           # Package metadata
├── project.json           # Nx configuration
└── README.md              # Documentation

Plugin Manifest

The plugin.json file defines the plugin:

json
{
  "name": "uniswap-hooks",
  "version": "1.3.0",
  "description": "AI-powered assistance for creating Uniswap V4 hooks",
  "author": {
    "name": "Uniswap Labs",
    "email": "ai-services@uniswap.org"
  },
  "license": "MIT",
  "skills": ["./skills/v4-security-foundations"]
}

Components

Skills

Skills are AI-powered capabilities defined in markdown:

markdown
---
name: skill-name
description: What the skill does
license: MIT
metadata:
  author: uniswap
---

# Skill Name

Instructions for the AI on how to perform this skill...

See Skills for available skills.

Agents

Agents are specialized AI configurations defined as markdown files in the agents/ directory. They provide expert-level assistance for specific domains:

markdown
---
name: swap-integration-expert
description: Expert agent for complex swap integration questions
---

Instructions for the agent on how to handle specialized queries...

Not all plugins include agents. Currently, uniswap-trading and uniswap-viem provide specialized expert agents.

Versioning

Plugins follow semantic versioning:

ChangeVersion Bump
Bug fixesPatch (1.0.X)
New features (backward compatible)Minor (1.X.0)
Breaking changesMajor (X.0.0)

Version is tracked in .claude-plugin/plugin.json.

Creating Plugins

See Creating Plugins for a detailed guide.

Released under the MIT License.