spec-workflow

AI Toolkit

Overview

The AI Toolkit is a standardized collection of AI agents, skills, and commands designed for Claude Code workflows. Its goal is to allow anyone at Uniswap to enhance Claude Code with powerful plugins via the Claude Code Marketplace.

What it provides:

• Plugin Marketplace: Install curated plugins that bundle agents, skills, commands, and MCP servers
• Pre-built AI Agents: Specialized subagents for code explanation, refactoring, testing, research, and more. Claude Code will use these automatically without any need for manual direction by the user
• Ready-to-use Skills & Commands: Quick access patterns (called "Slash commands") for common development workflows like reviewing PRs (/review-pr), generating tests (/generate-tests), and planning features (/plan-implementation)
• MCP Server Integrations: Pre-configured MCP servers for Linear, Notion, Graphite, and more
• Standardized Patterns: Create a common toolset of Claude Code commands and agents shared by everyone at Uniswap

Why it exists:

Instead of each person at Uniswap manually configuring AI assistant behaviors for each project, the AI Toolkit provides curated, tested plugins that can be installed via the Claude Code Marketplace. This makes AI-assisted development more consistent, efficient, and accessible to Uni teams.

Getting Started

Before working with this repository, ensure you have the following tools installed:

• Node.js 22+ with npm 11.7.0 (npm install -g [email protected])

Local Installation

# Clone the repository
git clone https://github.com/Uniswap/ai-toolkit
cd ai-toolkit

# Install all dependencies (also sets up git hooks automatically)
npm install

Setup Claude Code Integration

Option A: Install Plugins via Marketplace (Recommended)

The AI Toolkit provides plugins through the Claude Code Marketplace. To install, open Claude Code and run:

# Step 1: Add the Uniswap AI Toolkit marketplace
/plugin marketplace add Uniswap/ai-toolkit

# Step 2: Install the plugins you want
/plugin install development-planning@uniswap-ai-toolkit
/plugin install development-pr-workflow@uniswap-ai-toolkit
/plugin install development-codebase-tools@uniswap-ai-toolkit
/plugin install development-productivity@uniswap-ai-toolkit
/plugin install uniswap-integrations@uniswap-ai-toolkit

# Optional plugins
/plugin install spec-workflow@uniswap-ai-toolkit
/plugin install claude-setup@uniswap-ai-toolkit

Note: These commands are run inside the Claude Code REPL (i.e. after running claude in your terminal), not in your shell directly.

Option B: Install MCP Server Addons

# Run the CLI to see available options
npm run start

# Install MCP server addons
npx nx generate @uniswap/ai-toolkit-nx-claude:addons

Verify Installation

# Make sure you have Claude Code installed
claude # this should open up the Claude Code REPL

# View installed plugins and their capabilities
> /plugins

# Execute custom slash commands from installed plugins
> /review-pr
> /plan-implementation

Once installed, you'll have access to powerful Claude Code agents, skills, and commands that make development workflows more efficient and consistent.

Available Plugins

Plugin	Description
development-planning	Implementation planning & execution workflows
development-pr-workflow	PR management, review, & Graphite integration
development-codebase-tools	Code exploration, refactoring & analysis
development-productivity	Documentation, research, & prompt optimization
uniswap-integrations	External service integrations (Linear, Notion, etc.)
spec-workflow	Autonomous spec-driven development with multi-agent collaboration (optional)
claude-setup	Interactive setup wizard for configuring repos with Claude Code (optional)

Contributing

We welcome contributions from all developers! This project uses a trunk-based development workflow with automated publishing. Please read our Contributing Guide for detailed information about: