diff --git a/build-on-celo/build-with-ai/8004.mdx b/build-on-celo/build-with-ai/8004.mdx index b23620226..bda9cf2de 100644 --- a/build-on-celo/build-with-ai/8004.mdx +++ b/build-on-celo/build-with-ai/8004.mdx @@ -273,5 +273,5 @@ ERC-8004 works seamlessly with Celo's ecosystem: ## Related Protocols - [x402](/build-on-celo/build-with-ai/x402) - Payment layer for AI agents -- [Agent Skills](/build-on-celo/build-with-ai/agent-skills) - Modular agent capabilities +- [Celopedia](/build-on-celo/build-with-ai/celo-pedia) - Celo ecosystem knowledge for coding assistants - [MCP Servers](/build-on-celo/build-with-ai/mcp/index) - Connect agents to data and tools diff --git a/build-on-celo/build-with-ai/agent-skills.mdx b/build-on-celo/build-with-ai/agent-skills.mdx deleted file mode 100644 index 428a29206..000000000 --- a/build-on-celo/build-with-ai/agent-skills.mdx +++ /dev/null @@ -1,309 +0,0 @@ ---- -title: "Agent Skills" -sidebarTitle: "Agent Skills" ---- - -Agent Skills are modular, file-based capabilities that teach AI coding agents how to build on Celo and EVM chains. They provide specialized knowledge, workflows, and best practices that automatically activate when relevant tasks are detected. - -## Key Features - -- **Domain Expertise**: Packaged knowledge for specific development tasks -- **Auto-Activation**: Skills trigger automatically based on context -- **IDE Compatible**: Works with Claude Code, Cursor, Windsurf, and other AI coding tools -- **Modular**: Install individual skills or the complete collection - -## Installation - -### Install All Celo Skills - -```bash -npx openskills install celo-org/agent-skills -g -``` - -### Install a Specific Skill - -```bash -npx openskills install celo-org/agent-skills --skill evm-hardhat -g -``` - -### Using Other Package Managers - -```bash -# pnpm -pnpm dlx openskills install celo-org/agent-skills -g - -# yarn -yarn dlx openskills install celo-org/agent-skills -g - -# bun -bunx openskills install celo-org/agent-skills -g -``` - -## Available Skills - -### Development Tools - -| Skill | Description | -|-------|-------------| -| **evm-hardhat** | Hardhat development for EVM chains. Covers project setup, compilation, testing, deployment, and verification. | -| **evm-foundry** | Foundry development with forge, cast, anvil. Covers testing, deployment, and verification. | -| **celo-composer** | Scaffold Celo dApps with templates. Supports React, Next.js, and various wallet providers. | -| **contract-verification** | Verify smart contracts on Celoscan, Blockscout, Sourcify, and Remix. | - -### Blockchain Interaction - -| Skill | Description | -|-------|-------------| -| **celo-rpc** | Interact with Celo via RPC. Reading balances, transactions, blocks, and Celo-specific methods. | -| **viem** | TypeScript library with first-class support for fee currencies and CIP-64 transactions. | -| **wagmi** | React hooks for wallet connection, contract interaction, and transaction handling. | -| **fee-abstraction** | Pay gas fees with ERC-20 tokens (USDC, USDT, USDm) on Celo. | - -### Wallet Integration - -| Skill | Description | -|-------|-------------| -| **evm-wallet-integration** | Integrate wallets using Reown AppKit, Dynamic, or custom wagmi implementations. | -| **minipay-integration** | Build Mini Apps for MiniPay with wallet detection and stablecoin payments. | -| **thirdweb** | Full-stack Web3 development with contract deployment and pre-built components. | - -### DeFi & Assets - -| Skill | Description | -|-------|-------------| -| **celo-stablecoins** | Work with Mento stablecoins (USDm, cEUR, cREAL) and bridged stables (USDC, USDT). | -| **celo-defi** | DeFi protocol integration with Uniswap, Aave, and Ubeswap. | -| **bridging** | Bridge assets using native bridge, Wormhole, LayerZero, and other bridges. | - -## How Skills Work - -Skills use a **progressive disclosure** architecture to minimize token usage while maximizing relevance. Instead of loading entire documentation sets upfront (which would consume your AI assistant's context window), skills load information in layers. This keeps your AI assistant responsive while ensuring it has deep knowledge available when needed. - -For the complete specification, see [agentskills.io](https://agentskills.io). - -Skills follow this progressive disclosure model: - -``` -Level 1: Metadata (always loaded, ~100 tokens) - └── Name and description for activation detection - -Level 2: Instructions (loaded when triggered, <5000 tokens) - └── SKILL.md with workflows and examples - -Level 3: Resources (loaded on-demand) - └── references/, rules/, scripts/ -``` - -### Skill Structure - -``` -skill-name/ -├── SKILL.md # Main instructions (required) -├── references/ # Detailed documentation -├── rules/ # Best practices and standards -└── scripts/ # Executable scripts -``` - -## Using Skills - -Once installed, skills activate automatically. Just ask your AI coding agent to perform a task: - -### Example: Deploy a Contract - -``` -You: "Deploy this ERC20 token to Celo Sepolia" - -AI: [evm-hardhat skill activates] - - Sets up hardhat.config.ts with Celo networks - - Compiles the contract - - Deploys to Celo Sepolia - - Verifies on Celoscan -``` - -### Example: Pay Gas with Stablecoins - -``` -You: "Send a transaction paying gas in USDC" - -AI: [fee-abstraction skill activates] - - Uses viem with feeCurrency parameter - - Sets USDC adapter address - - Sends CIP-64 transaction -``` - -### Example: Build a MiniPay App - -``` -You: "Create a simple payment app for MiniPay" - -AI: [minipay-integration skill activates] - - Scaffolds Next.js project with celo-composer - - Adds MiniPay wallet detection - - Implements stablecoin transfer - - Configures for mobile-first design -``` - -## Skill Examples - -### evm-hardhat - -The Hardhat skill includes configuration for Celo networks: - -```typescript -// Generated hardhat.config.ts -const config: HardhatUserConfig = { - solidity: "0.8.28", - networks: { - celo: { - url: "https://forno.celo.org", - chainId: 42220, - accounts: [process.env.PRIVATE_KEY], - }, - celoSepolia: { - url: "https://forno.celo-sepolia.celo-testnet.org", - chainId: 11142220, - accounts: [process.env.PRIVATE_KEY], - }, - }, - etherscan: { - apiKey: { - celo: process.env.CELOSCAN_API_KEY, - }, - }, -}; -``` - -### fee-abstraction - -The fee abstraction skill teaches paying gas in stablecoins: - -```typescript -import { createWalletClient, custom } from "viem"; -import { celo } from "viem/chains"; - -// USDC adapter address for fee payment -const USDC_ADAPTER = "0x2F25deB3848C207fc8E0c34035B3Ba7fC157602B"; - -const walletClient = createWalletClient({ - chain: celo, - transport: custom(window.ethereum), -}); - -const hash = await walletClient.sendTransaction({ - to: recipientAddress, - value: parseEther("0.01"), - feeCurrency: USDC_ADAPTER, // Pay gas in USDC -}); -``` - -### celo-rpc - -The RPC skill covers blockchain interactions: - -```typescript -import { createPublicClient, http } from "viem"; -import { celo } from "viem/chains"; - -const client = createPublicClient({ - chain: celo, - transport: http("https://forno.celo.org"), -}); - -// Get CELO balance -const balance = await client.getBalance({ - address: "0x...", -}); - -// Get USDm token balance -const USDm = "0x765de816845861e75a25fca122bb6898b8b1282a"; -const tokenBalance = await client.readContract({ - address: USDm, - abi: erc20Abi, - functionName: "balanceOf", - args: [userAddress], -}); -``` - -## Creating Custom Skills - -You can create skills for your own workflows: - -### 1. Create Skill Directory - -```bash -mkdir -p ~/.claude/skills/my-custom-skill -``` - -### 2. Write SKILL.md - -```markdown ---- -name: my-custom-skill -description: Handles specific tasks for my project. - Use when building features related to X. ---- - -# My Custom Skill - -## When to Use -- Task type 1 -- Task type 2 - -## Process - -### Step 1: Setup -Instructions here... - -### Step 2: Implementation -More instructions... - -## Examples - -**Input**: "Do X with Y" -**Output**: Expected result... -``` - -### 3. Add Resources (Optional) - -``` -my-custom-skill/ -├── SKILL.md -├── references/ -│ └── api-docs.md -├── rules/ -│ └── best-practices.md -└── scripts/ - └── helper.py -``` - -## Celo Network Reference - -| Network | Chain ID | RPC Endpoint | Explorer | -|---------|----------|--------------|----------| -| Celo Mainnet | 42220 | https://forno.celo.org | https://celoscan.io | -| Celo Sepolia | 11142220 | https://forno.celo-sepolia.celo-testnet.org | https://sepolia.celoscan.io | - -## Contributing - -Want to add a new skill? See the [contribution guide](https://github.com/celo-org/agent-skills/blob/main/CONTRIBUTING.md). - -**Quality checklist:** -- [ ] SKILL.md follows the Agent Skills spec -- [ ] All contract addresses are verified on block explorers -- [ ] Code examples have been tested -- [ ] No deprecated APIs or testnets -- [ ] All links are valid - -## Resources - -| Resource | Link | -|----------|------| -| Celo Agent Skills | [github.com/celo-org/agent-skills](https://github.com/celo-org/agent-skills) | -| Agent Skills Spec | [agentskills.io](https://agentskills.io) | -| OpenSkills CLI | [npmjs.com/package/openskills](https://www.npmjs.com/package/openskills) | - -## Related - -- [ERC-8004](/build-on-celo/build-with-ai/8004) - Trust layer for AI agents -- [x402](/build-on-celo/build-with-ai/x402) - Payment layer for AI agents -- [Celo MCP](/build-on-celo/build-with-ai/mcp/celo-mcp) - MCP server for Celo blockchain diff --git a/build-on-celo/build-with-ai/celo-pedia.mdx b/build-on-celo/build-with-ai/celo-pedia.mdx new file mode 100644 index 000000000..d60fba2e0 --- /dev/null +++ b/build-on-celo/build-with-ai/celo-pedia.mdx @@ -0,0 +1,81 @@ +--- +title: "Celopedia" +sidebarTitle: "Celopedia" +description: "Use Celopedia to query Celo ecosystem data, protocol references, contract addresses, MiniPay guidance, DeFi protocols, grants, and AI agent infrastructure from your coding assistant." +--- + +Celopedia is a builder-focused knowledge skill for Celo. It packages Celo ecosystem intelligence, protocol references, verified contract addresses, MiniPay guidance, DeFi protocol context, grant information, and AI agent infrastructure into a skill that coding assistants can use while you build. + +Use it when you want your AI coding agent to answer Celo-specific questions, compare ecosystem opportunities, find contract addresses, scaffold common development patterns, or reason about MiniPay, DeFi, stablecoins, governance, and agentic applications on Celo. + +## What you can do with Celopedia + +- **Research ecosystem opportunities**: Search ecosystem data, compare verticals, and identify gaps before you build. +- **Find contract addresses**: Look up verified addresses for core protocol contracts, Mento stablecoins, Uniswap, Aave, Morpho, bridge contracts, and more. +- **Build MiniPay apps**: Get MiniPay wallet detection, payment, testing, and submission guidance. +- **Integrate DeFi protocols**: Ask for Celo-specific patterns for protocols such as Uniswap, Aave, Morpho, Mento, Velodrome, Curve, Ubeswap, and stCELO. +- **Explore grants and funding**: Match a project idea to relevant Celo grant programs and builder support options. +- **Build AI agents on Celo**: Use references for ERC-8004, x402, the Celo MCP Server, and agent skills. + +## Install + +Install Celopedia with `npx skills`: + +```bash +npx skills add celo-org/celopedia-skills +``` + +After installing, restart your coding assistant if it does not discover new skills during an active session. + + + Celopedia supports agent environments that use file-based skills, including Codex, Claude Code, and OpenClaw. See the GitHub repository for tool-specific install notes. + + +## Example prompts + +Once installed, ask your coding assistant questions like: + +```text +What lending protocols exist on Celo? +``` + +```text +Give me the Uniswap V4 contract addresses on Celo mainnet. +``` + +```text +I want to build a payments Mini App. Show me the recommended architecture. +``` + +```text +What grants can I apply to for a DeFi project on Celo? +``` + +```text +Set up a Foundry project for Celo with fee abstraction. +``` + +```text +How saturated is the DEX vertical on Celo compared with other EVM chains? +``` + +## What's included + +| Area | Included references | +|------|---------------------| +| Network and contracts | Chain IDs, RPCs, explorers, fee currencies, RPC limits, and verified contract addresses | +| Ecosystem intelligence | Product discovery, competitor scans, vertical analysis, and Celo ecosystem context | +| Builder setup | Foundry, Hardhat, Viem, Wagmi, fee abstraction, deployment, and verification patterns | +| DeFi | Protocol references for Uniswap, Aave, Morpho, Mento, Velodrome, Curve, Ubeswap, and stCELO | +| MiniPay | Mini App development, wallet detection, stablecoin payments, ODIS, templates, and listing guidance | +| AI agents | ERC-8004, x402, Celo MCP Server, and agent skill references | +| Grants | Funding programs and grant matchmaking guidance | + +## Data sources + +Celopedia is curated from official Celo documentation, protocol references, ecosystem data sources, and live public APIs where applicable. Its sources include Celo Docs, The Grid, DefiLlama, Celoscan, MiniPay references, and protocol documentation from teams across the Celo ecosystem. + +## Resources + +- [Celopedia](https://celopedia.celo.org/) +- [Celopedia GitHub repository](https://github.com/celo-org/celopedia-skills) diff --git a/build-on-celo/build-with-ai/overview.mdx b/build-on-celo/build-with-ai/overview.mdx index 5a948bbbc..841c396a4 100644 --- a/build-on-celo/build-with-ai/overview.mdx +++ b/build-on-celo/build-with-ai/overview.mdx @@ -7,7 +7,7 @@ sidebarTitle: "Overview" Celo is a leading Ethereum Layer 2 optimized for agentic activity with real-world utility, enabling AI agents to autonomously perform onchain actions tied directly to payments, commerce, and financial coordination. -Agents on Celo can tap into the network's expansive payments ecosystem, leveraging fast finality, sub-cent transaction costs, and a stablecoin-optimized financial stack spanning peer-to-peer transfers, merchant payments, remittances, and onchain FX. Combined with native support for AI agent standards like [ERC-8004](/build-on-celo/build-with-ai/8004) and Celo's [Agent Skills](/build-on-celo/build-with-ai/agent-skills), Celo provides a production-ready environment for deploying AI agents that do more than trade tokens—they move money, coordinate economic activity, and interact with real users at global scale. +Agents on Celo can tap into the network's expansive payments ecosystem, leveraging fast finality, sub-cent transaction costs, and a stablecoin-optimized financial stack spanning peer-to-peer transfers, merchant payments, remittances, and onchain FX. Combined with native support for AI agent standards like [ERC-8004](/build-on-celo/build-with-ai/8004) and Celo's [Celopedia](/build-on-celo/build-with-ai/celo-pedia), Celo provides a production-ready environment for deploying AI agents that do more than trade tokens—they move money, coordinate economic activity, and interact with real users at global scale. ## Why Build AI Agents on Celo diff --git a/build-on-celo/build-with-ai/x402.mdx b/build-on-celo/build-with-ai/x402.mdx index 724e0ad01..3562b8a62 100644 --- a/build-on-celo/build-with-ai/x402.mdx +++ b/build-on-celo/build-with-ai/x402.mdx @@ -336,5 +336,5 @@ app.get("/articles/:id", async (req, res) => { ## Related - [ERC-8004](/build-on-celo/build-with-ai/8004) - Trust layer for AI agents -- [Agent Skills](/build-on-celo/build-with-ai/agent-skills) - Modular agent capabilities +- [Celopedia](/build-on-celo/build-with-ai/celo-pedia) - Celo ecosystem knowledge for coding assistants - [Fee Abstraction](/build-on-celo/fee-abstraction/overview) - Pay gas with stablecoins on Celo diff --git a/docs.json b/docs.json index 408e5de18..982748c05 100644 --- a/docs.json +++ b/docs.json @@ -132,7 +132,7 @@ "pages": [ "build-on-celo/build-with-ai/8004", "build-on-celo/build-with-ai/x402", - "build-on-celo/build-with-ai/agent-skills", + "build-on-celo/build-with-ai/celo-pedia", "build-on-celo/build-with-ai/vibe-coding" ] },