--- slug: "celopedia-skills" source_type: "readme" source_url: "https://cdn.jsdelivr.net/gh/celo-org/celopedia-skills@main/README.md" repo: "https://github.com/celo-org/celopedia-skills" source_file: "README.md" branch: "main" --- # Celopedia Skill The comprehensive skill for building on Celo. Ecosystem intelligence, developer tools, DeFi protocols, MiniPay integration, AI agent infrastructure, governance, grants, and verified contract addresses — all in one install. ## Install For Codex and OpenClaw (installs to `.agents/skills/`): ```bash npx skills add celo-org/celopedia-skills ``` ### Claude Code Claude Code only discovers skills under `.claude/skills/` (project) or `~/.claude/skills/` (user), so `npx skills add` alone is not enough. Pick one of: **Option A — symlink (keeps `.agents/` as the source of truth, recommended on macOS/Linux):** ```bash npx skills add celo-org/celopedia-skills mkdir -p .claude ln -s ../.agents/skills .claude/skills ``` **Option B — install directly under `.claude/skills/`:** ```bash mkdir -p .claude/skills git clone --depth 1 https://github.com/celo-org/celopedia-skills.git /tmp/celopedia cp -r /tmp/celopedia/skills/celopedia-skill .claude/skills/ rm -rf /tmp/celopedia ``` Restart Claude Code after installing — creating a new top-level `.claude/` directory mid-session is not picked up live. Verify with `/skills` or by asking "what skills are available?". ## What it does ### Ecosystem Intelligence Search 6,300+ crypto products via The Grid, find competitors, analyze vertical saturation, and discover what's deployed on Celo vs other EVM chains. ### Builder Assistant Foundry/Hardhat configs for Celo, fee abstraction implementation, SDK selection guide (Viem, Wagmi, ContractKit, Thirdweb), deployment and verification workflows, and ERC-8021 attribution tags for impact tracking. ### DeFi Reference Deep protocol reference for Uniswap V3/V4, Aave V3, Carbon DeFi, Morpho Blue, Mento stablecoins, stCELO, Velodrome, and Curve on Celo. Includes contract addresses, interaction patterns, and yield strategies. ### MiniPay App Builder Build Mini Apps for MiniPay (16M+ wallets). Wallet detection, auto-connect patterns, stablecoin payments, phone number resolution, testing with ngrok, and ready-to-use code templates. Includes the official submission checklist (UI copy rules, 360×640, PageSpeed, ToS/Privacy, 24h SLA). ### AI Agent Builder ERC-8004 (Agent Trust Protocol), Self Agent ID (proof-of-human), the Celo Agent Visa program, x402 (HTTP micropayments, with Celo's hosted facilitator at [x402.celo.org](https://x402.celo.org)), Celo MCP Server, and the Agent Skills specification. Build onchain agents that transact autonomously on Celo. ### Security & Audit Readiness Celo-specific security patterns (CELO duality, CIP-64 fee abstraction, Aave aToken drift, Mento circuit breakers, post-L2 epoch effects). Chain-agnostic Solidity audits defer to [pashov/skills](https://github.com/pashov/skills). ### Governance On-chain governance reference: proposal lifecycle, voting with Mondo/CeloCLI, Security Council, epoch rewards, and carbon offset fund. ### Contract Addresses 150+ verified addresses from docs.celo.org — core protocol, 15+ Mento stablecoins, L1 bridge contracts, Uniswap V3/V4, Aave V3, Morpho Blue, and testnet deployments. ### Grant Matchmaking 20+ grant programs tracked (3 live, 17 past) with a matchmaking guide. Find the right grant based on what you're building. ## Usage Once installed, the skill activates automatically. Just describe what you need: - *"What lending protocols exist on Celo?"* - *"Set up a Foundry project for Celo with fee abstraction"* - *"Give me the Uniswap V4 contract addresses on Celo mainnet"* - *"I want to build a payments Mini App — show me how"* - *"How do I integrate Aave V3 on Celo?"* - *"What grants can I apply to for a DeFi project?"* - *"How saturated is the DEX vertical on EVM chains?"* - *"Build an AI agent that makes micropayments with x402"* ## Data Sources | Source | What | Auth | |--------|------|------| | [The Grid](https://beta.node.thegrid.id/graphql) | 6,300+ crypto products, live ecosystem data | None (public) | | [docs.celo.org](https://docs.celo.org) | Contract addresses, network info, documentation | None | | [DefiLlama](https://defillama.com/chain/Celo) | TVL data (linked, not embedded) | None | | [Carbon DeFi](https://docs.carbondefi.xyz) | Contract addresses, MCP server, strategy patterns | None | | [celo-org/agent-skills](https://github.com/celo-org/agent-skills) | SDK patterns, code examples | None | ## Structure The skill lives at `skills/celopedia-skill/` and is organized into topic-grouped references. `SKILL.md` is the main definition (v2.0.0); everything else is loaded on demand. ### Ecosystem Intelligence | File | What | |------|------| | [`network-info.md`](https://github.com/celo-org/celopedia-skills/blob/HEAD/skills/celopedia-skill/references/network-info.md) | Chain IDs, RPCs, explorers, fee currencies, RPC limits | | [`contracts.md`](https://github.com/celo-org/celopedia-skills/blob/HEAD/skills/celopedia-skill/references/contracts.md) | 150+ verified contract addresses | | [`ecosystem.md`](https://github.com/celo-org/celopedia-skills/blob/HEAD/skills/celopedia-skill/references/ecosystem.md) | 30+ DeFi protocols, infra, MiniPay apps | | [`the-grid-skill.md`](https://github.com/celo-org/celopedia-skills/blob/HEAD/skills/celopedia-skill/references/the-grid-skill.md) | 9 GraphQL query templates for The Grid | | [`grants-funding.md`](https://github.com/celo-org/celopedia-skills/blob/HEAD/skills/celopedia-skill/references/grants-funding.md) | Grant programs with mandatory live-fetch directive | | [`docs-map.md`](https://github.com/celo-org/celopedia-skills/blob/HEAD/skills/celopedia-skill/references/docs-map.md) | Full `docs.celo.org` sitemap (~150 pages) | | [`live-data-sources.md`](https://github.com/celo-org/celopedia-skills/blob/HEAD/skills/celopedia-skill/references/live-data-sources.md) | DefiLlama, celopg.eco, RPC, Blockscout APIs | ### Builder Assistant | File | What | |------|------| | [`builder-guide.md`](https://github.com/celo-org/celopedia-skills/blob/HEAD/skills/celopedia-skill/references/builder-guide.md) | Celo-specific dev patterns and gotchas | | [`dev-templates.md`](https://github.com/celo-org/celopedia-skills/blob/HEAD/skills/celopedia-skill/references/dev-templates.md) | Foundry, Hardhat, Viem, Wagmi configs | | [`sdk-reference.md`](https://github.com/celo-org/celopedia-skills/blob/HEAD/skills/celopedia-skill/references/sdk-reference.md) | SDK quick reference and selection guide | | [`attribution-tags.md`](https://github.com/celo-org/celopedia-skills/blob/HEAD/skills/celopedia-skill/references/attribution-tags.md) | Attribution tags (ERC-8021) — tag transactions for impact tracking & future rewards | ### DeFi | File | What | |------|------| | [`defi-protocols.md`](https://github.com/celo-org/celopedia-skills/blob/HEAD/skills/celopedia-skill/references/defi-protocols.md) | Deep protocol reference (Uniswap, Aave, Carbon DeFi, Morpho, Mento) with live APY fetching | ### MiniPay App Builder | File | What | |------|------| | [`minipay-guide.md`](https://github.com/celo-org/celopedia-skills/blob/HEAD/skills/celopedia-skill/references/minipay-guide.md) | Complete MiniPay development guide | | [`minipay-templates.md`](https://github.com/celo-org/celopedia-skills/blob/HEAD/skills/celopedia-skill/references/minipay-templates.md) | Ready-to-use Mini App code templates | | [`minipay-scaffold-from-scratch.md`](https://github.com/celo-org/celopedia-skills/blob/HEAD/skills/celopedia-skill/references/minipay-scaffold-from-scratch.md) | Raw Next.js + viem setup (alternative to Celo Composer) | | [`odis-socialconnect.md`](https://github.com/celo-org/celopedia-skills/blob/HEAD/skills/celopedia-skill/references/odis-socialconnect.md) | ODIS (PnP), OdisPayments, FederatedAttestations | | [`minipay-live-apps.md`](https://github.com/celo-org/celopedia-skills/blob/HEAD/skills/celopedia-skill/references/minipay-live-apps.md) | Discovery snapshot: live Mini Apps, categories, country targeting | | [`minipay-requirements.md`](https://github.com/celo-org/celopedia-skills/blob/HEAD/skills/celopedia-skill/references/minipay-requirements.md) | Two-stage MiniPay listing flow: Stage 1 intake form (`minipay.to/mini-apps`) and Stage 2 post-call readiness checklist | | [`minipay-docs-map.md`](https://github.com/celo-org/celopedia-skills/blob/HEAD/skills/celopedia-skill/references/minipay-docs-map.md) | Page-by-page index of `docs.minipay.xyz` (getting started, guides, technical references, deeplinks) | ### Platform Features | File | What | |------|------| | [`governance.md`](https://github.com/celo-org/celopedia-skills/blob/HEAD/skills/celopedia-skill/references/governance.md) | On-chain governance reference | | [`ai-agents.md`](https://github.com/celo-org/celopedia-skills/blob/HEAD/skills/celopedia-skill/references/ai-agents.md) | ERC-8004, x402 + hosted Celo facilitator, MCP, Agent Skills | | [`security-patterns.md`](https://github.com/celo-org/celopedia-skills/blob/HEAD/skills/celopedia-skill/references/security-patterns.md) | Celo-specific security risks (pairs with [pashov/skills](https://github.com/pashov/skills)) | ## Contributing Data is sourced from official Celo documentation. If you find outdated information: 1. Check [docs.celo.org](https://docs.celo.org) for the current value 2. Update the relevant reference file 3. Bump the version in `SKILL.md` 4. Open a PR ## License Apache-2.0