docs: LLMs page update + adding API references to the llm.txt file

Author: ocandocrypto-uniswap

docs/llms/overview.md

@@ -4,52 +4,97 @@ sidebar_position: 1
 title: Overview
 ---
 
-# LLMs and AI Integration
+# Uniswap AI Tools for Developers
 
-Large Language Models (LLMs) and AI tools can help developers better understand and work with the Uniswap Protocol. This section provides resources and guidance for leveraging AI assistance when building on Uniswap.
+Uniswap provides AI-powered development tools that help you integrate swaps, build v4 hooks, provide liquidity, and interact with the EVM from within your editor.
 
-## AI-Powered Documentation
+## Quick links
 
-The Uniswap documentation is designed to work seamlessly with modern AI tools to provide enhanced developer support and assistance.
+- [Uniswap AI](#uniswap-ai)
+- [LLM Context Files](#llm-context-files)
+- [Code Editor Setup](#code-editor-setup)
 
-### Getting AI Help
+## Uniswap AI
 
-Use the built-in AI integration features throughout the documentation:
+[Uniswap AI](https://github.com/Uniswap/uniswap-ai) is an open-source collection of plugins and skills that gives AI coding agents up-to-date, protocol-specific guidance across Uniswap protocols, APIs, and smart contracts.
 
-- **Copy to AI**: Use the dropdown button on any documentation page to quickly get AI assistance
-- **Context-Aware**: AI tools receive relevant documentation context for better responses
-- **Multiple Platforms**: Integrate with popular AI assistants like Claude and ChatGPT
+### Available plugins
 
-## LLMs.txt
+| Plugin | Description |
+| --- | --- |
+| **uniswap-trading** | Integrate swaps via [Trading API](https://developers.uniswap.org/dashboard), Universal Router SDK, or direct contract calls. |
+| **uniswap-hooks** | Security-first guidance for building Uniswap v4 hooks. |
+| **uniswap-viem** | EVM integration with viem and wagmi. |
+| **uniswap-driver** | Token discovery and swap/liquidity planning with deep links. |
+| **uniswap-cca** | Configure and deploy CCA contracts for token distribution. |
 
-This documentation includes an [LLMs.txt file](/llms.txt) that provides comprehensive context about Uniswap for AI systems. This file helps ensure AI assistants can provide accurate and up-to-date information about:
+### Install with the Skills CLI
 
-- Protocol architecture and concepts
-- Smart contract interfaces and functionality
-- SDK usage and integration patterns
-- Development best practices
+Uniswap AI is available through [skills.sh](https://github.com/Uniswap/uniswap-ai). This works with any AI coding agent that supports skill files:
 
-## Best Practices for AI-Assisted Development
+```bash
+npx skills add uniswap/uniswap-ai
+```
 
-When using AI tools for Uniswap development:
+### Install as a Claude Code plugin
 
-1. **Provide Context**: Always include relevant protocol version (v2, v3, v4) in your queries
-2. **Verify Code**: Always test and verify AI-generated code before deployment
-3. **Reference Documentation**: Cross-check AI responses against official documentation
-4. **Security First**: Have AI-generated smart contracts audited before production use
+If you use [Claude Code](https://claude.ai/code), first add the Uniswap marketplace, then install individual plugins:
 
-## Supported AI Platforms
+```bash
+# Add the Uniswap marketplace
+/plugin marketplace add uniswap/uniswap-ai
 
-The documentation provides optimized integration with:
+# Install individual plugins
+claude plugin add uniswap-hooks     # v4 hook development
+claude plugin add uniswap-trading   # Swap integration
+claude plugin add uniswap-viem      # EVM / viem / wagmi
+claude plugin add uniswap-driver    # Token discovery & deep links
+claude plugin add uniswap-cca       # CCA auction configuration
+```
 
-- **Claude**: Advanced reasoning for complex DeFi concepts
-- **ChatGPT**: Code generation and debugging assistance
-- **Other LLMs**: Compatible with any AI tool that supports context injection
+Once installed, the plugins activate automatically when relevant to your task. You can also invoke specific skills directly. For example, **/uniswap-hooks:v4-security-foundations** for a security-first walkthrough of hook development.
 
-## Contributing AI Resources
+## LLM Context Files
 
-Help improve AI assistance for the Uniswap community by:
+If you prefer to give your AI agent raw documentation context rather than structured skills, Uniswap publishes LLM-optimized text files that summarize the protocol documentation.
 
-- Reporting AI-generated errors or inaccuracies
-- Suggesting improvements to the LLMs.txt context file
-- Contributing examples of effective AI prompts for Uniswap development
+### llms.txt and llms-full.txt
+
+AI models have a context window (the amount of text they can process at once). Providing relevant documentation upfront helps the model give better answers without hallucinating.
+
+Uniswap offers two context files:
+- **[llms.txt](https://docs.uniswap.org/v4-llms.txt)**: A compact summary with links to documentation sections. Works well with most models (100K+ token context windows).
+- **[llms-full.txt](https://docs.uniswap.org/v4-llms-full.txt)**: A verbose version with more inline content. Use this if your model has a larger context window or you want more detail without following links.
+
+## Code Editor Setup
+
+### Cursor
+
+1. Navigate to **Cursor Settings > Features > Docs**
+2. Select **Add new doc** and paste one of the following URLs:
+
+```
+https://docs.uniswap.org/v4-llms.txt
+```
+
+```
+https://docs.uniswap.org/v4-llms-full.txt
+```
+
+3. Use `@docs` → **Uniswap** to reference the documentation in your chat.
+
+### Windsurf
+
+Windsurf requires referencing documentation in each conversation. Add it to the Cascade window (`CMD+L`):
+
+```
+@docs:https://docs.uniswap.org/v4-llms.txt
+```
+
+```
+@docs:https://docs.uniswap.org/v4-llms-full.txt
+```
+
+### Claude Code
+
+Install the Uniswap AI plugins (see [above](#install-as-a-claude-code-plugin)) for the richest integration. The plugins provide structured skills, expert agents, and protocol-specific tools that go beyond static documentation context.

static/llms.txt

@@ -132,6 +132,11 @@ Uniswap is a decentralized exchange protocol built on Ethereum that enables user
 - GitHub: https://github.com/Uniswap
 - Governance: https://gov.uniswap.org
 
+### AI and API Resources
+- Uniswap API Docs (Introduction): https://api-docs.uniswap.org/introduction
+- Uniswap Developer Portal (API keys and onboarding): https://developers.uniswap.org/
+- Uniswap AI toolkit and skills: https://github.com/Uniswap/uniswap-ai
+
 ### Community
 - Discord: https://discord.gg/uniswap
 - Twitter: https://twitter.com/Uniswap