uniswap/uniswap-ai
11 skills8.5k installs2.4k starsGitHub
Install
npx skills add https://github.com/uniswap/uniswap-aiSkills in this repo
1Swap IntegrationThe swap-integration skill is designed for integrate Uniswap swaps into applications. Use when user says "integrate swaps", "uniswap", "trading api", "add swap functionality", "build a swap frontend", "create a swap. Swap Integration Integrate Uniswap swaps into frontends, backends, and smart contracts. Prerequisites This skill assumes familiarity with viem basics (client setup, account management, contract interactions, transaction signing). Invoke when the user user says "integrate swaps", "uniswap", "trading api", "add swap functionality", "build a swap frontend", "create a swap script", "smart contract swap integration", "use Universal Router", "Trading API", or mentions swapping tokens via Uniswap.1.5kinstalls2Viem Integrationviem-integration is a Web3 development skill from uniswap/uniswap-ai that documents private key accounts, HD wallets, message signing, and WalletClient setup with viem in TypeScript. The reference covers privateKeyToAccount, createWalletClient, http transport, and mainnet chain imports with production warnings against test keys. Developers reach for viem-integration when building DeFi bots, swap agents, or on-chain automation that must derive addresses, sign messages, and submit transactions through viem instead of ethers.js or web3.js.936installs3Liquidity Plannerliquidity-planner documents data providers for Uniswap LP position agents in the uniswap-ai repository. DexScreener serves as the primary source for pool discovery, prices, TVL, and volume with no authentication and a 300 requests/minute limit. DefiLlama supplements APY and yield data when available. Supported network IDs include ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, and unichain. Developers reach for liquidity-planner when building agents that need curl-ready DexScreener token-pair lookups and yield context before recommending Uniswap liquidity positions.905installs4Swap Plannerswap-planner is a Claude skill documenting data providers for Uniswap swap planning: DexScreener as the primary source for pool discovery, prices, and liquidity, with DefiLlama fallback for prices and pool TVL. DexScreener requires no authentication and allows 300 requests per minute across network IDs including ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, and unichain. Developers reach for swap-planner when agents need reliable token quotes, pair discovery, or TVL checks before routing swaps on Uniswap deployments. Coverage is deepest on Ethereum, Base, and Arbitrum; Celo, Blast, Zora, and World Chain may return fewer pairs. The skill outputs API call patterns, chain mappings, and provider selection logic for production swap planners.902installs5V4 Security Foundationsv4-security-foundations is a skill from uniswap/uniswap-ai providing a comprehensive pre-deployment audit checklist for Uniswap v4 hooks. It verifies every hook callback checks msg.sender equals address(poolManager), enforces router allowlisting with admin-protected modifications, requires two-step admin transfers, and validates delta accounting and settlement invariants before mainnet deployment. Developers reach for v4-security-foundations when reviewing custom v4 hook Solidity before launch, ensuring no code path bypasses PoolManager verification and zero addresses cannot enter allowlists. The checklist spans access control, router authorization, admin function safeguards, and accounting correctness for production DeFi deployments.866installs6Deployerdeployer is a Uniswap uniswap-ai skill (version 1.0.0, MIT license) for deploying Continuous Clearing Auction (CCA) smart contracts via the ContinuousClearingAuctionFactory with CREATE2 for consistent addresses across chains. The skill uses forge, cast, and curl Bash commands plus Read, Glob, and Grep to walk through factory deployment when users say deploy auction, deploy cca, or factory deployment. It prompts interactively via AskUserQuestion for chain and configuration choices. Developers reach for deployer when launching multi-chain CCA auctions and need deterministic contract addresses rather than ad-hoc manual deployments.845installs7Configuratorconfigurator is a Uniswap AI skill (version 1.0.0, MIT) for configuring Continuous Clearing Auction (CCA) smart contract parameters through an interactive bulk-form flow. The skill triggers on phrases like configure auction, CCA auction, setup token auction, and continuous auction, then walks parameter entry with Read, Write, Edit, Glob, Grep, Bash(curl), WebFetch, and AskUserQuestion. It calls bundled tools cca-supply-schedule__generate_supply_schedule and cca-supply-schedule__encode_supply_schedule to produce encoded supply schedules ready for contract deployment. Developers reach for configurator when launching transparent token auctions on Uniswap infrastructure without hand-rolling every CCA field and schedule encoding step.839installs8Pay With Any Tokenpay-with-any-token is a Uniswap uniswap-ai skill at version 2.0.0 that guides coding agents through HTTP 402 Payment Required, Machine Payments Protocol (MPP), and x402 paid API access. The primary flow uses the Tempo CLI tempo request command to call paid APIs and handle 402 challenges automatically. When the Tempo wallet lacks balance, the skill plans EXACT_OUTPUT swaps and bridges ERC-20 tokens from supported EVM chains via the Uniswap Trading API at trade-api.gateway.uniswap.org/v1, including Across Protocol bridging to Tempo. A mandatory AskUserQuestion gate blocks on-chain transactions without explicit user confirmation, and input validation blocks shell metacharacters from adversarial 402 bodies. Developers reach for pay-with-any-token when agents must pay for API access with any held token rather than pre-funded stablecoins.574installs9V4 Sdk Integrationv4-sdk-integration is an MIT-licensed agent skill from uniswap/uniswap-ai at metadata version 1.0.0 that documents app-layer Uniswap v4 SDK patterns for swaps, quotes, and liquidity management. The skill activates on prompts mentioning v4 sdk, uniswap v4, v4 swap, v4 liquidity, PoolManager, V4Planner, StateView, PositionManager, pool state, or v4 positions. It targets developers building swap and liquidity experiences directly with SDKs rather than routing through the Uniswap Trading API, and contrasts with Solidity hook development covered elsewhere. Allowed tools include Read, Write, Edit, Glob, Grep, and Bash for npm, npx, yarn, and curl, reflecting typical JavaScript package workflows. The skill explains reading pool state, planning swaps with V4Planner, and managing positions through PositionManager abstractions. Reach for v4-sdk-integration when wiring wallet-connected React or Node clients to v4 pools. Skip it when integrations only need the hosted Trading API or pure smart-contract hook authoring without app SDK code.442installs10V4 Hook Generatorv4-hook-generator is a version 1.0.0 MIT-licensed agent skill from Uniswap/uniswap-ai that scaffolds Uniswap v4 hook contracts through the OpenZeppelin Contracts Wizard MCP tool. The skill documents 14 base hook types—from BaseHook and BaseCustomCurve to AntiSandwichHook, LimitOrderHook, and OracleHookWithV3Adapters—and all 14 permission flags with LOW to CRITICAL risk ratings, including the NoOp attack vector on beforeSwapReturnDelta. A six-step checklist covers hook type, permissions, utility libraries (currencySettler, safeCast, transientStorage), shares (ERC20/ERC6909/ERC1155), access control (ownable/roles/managed), and hook inputs. The canonical generate_hook MCP JSON schema produces ready-to-compile Solidity that developers write to disk manually, with HookMiner required for address bit encoding. The workflow ends by invoking v4-security-foundations before deployment. Reach for v4-hook-generator when building custom AMM curves, dynamic fees, MEV protection, or oracle hooks on Uniswap v4.415installs11Pay With Apppay-with-app is a Claude Code skill for ai & agent building. It helps solo builders move faster with AI-assisted development.287installs