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/):

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):

npx skills add celo-org/celopedia-skills
mkdir -p .claude
ln -s ../.agents/skills .claude/skills

Option B — install directly under .claude/skills/:

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), 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.

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	6,300+ crypto products, live ecosystem data	None (public)
docs.celo.org	Contract addresses, network info, documentation	None
DefiLlama	TVL data (linked, not embedded)	None
Carbon DeFi	Contract addresses, MCP server, strategy patterns	None
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	Chain IDs, RPCs, explorers, fee currencies, RPC limits
contracts.md	150+ verified contract addresses
ecosystem.md	30+ DeFi protocols, infra, MiniPay apps
the-grid-skill.md	9 GraphQL query templates for The Grid
grants-funding.md	Grant programs with mandatory live-fetch directive
docs-map.md	Full docs.celo.org sitemap (~150 pages)
live-data-sources.md	DefiLlama, celopg.eco, RPC, Blockscout APIs

Builder Assistant

File	What
builder-guide.md	Celo-specific dev patterns and gotchas
dev-templates.md	Foundry, Hardhat, Viem, Wagmi configs
sdk-reference.md	SDK quick reference and selection guide
attribution-tags.md	Attribution tags (ERC-8021) — tag transactions for impact tracking & future rewards

DeFi

File	What
defi-protocols.md	Deep protocol reference (Uniswap, Aave, Carbon DeFi, Morpho, Mento) with live APY fetching

MiniPay App Builder

File	What
minipay-guide.md	Complete MiniPay development guide
minipay-templates.md	Ready-to-use Mini App code templates
minipay-scaffold-from-scratch.md	Raw Next.js + viem setup (alternative to Celo Composer)
odis-socialconnect.md	ODIS (PnP), OdisPayments, FederatedAttestations
minipay-live-apps.md	Discovery snapshot: live Mini Apps, categories, country targeting
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	Page-by-page index of docs.minipay.xyz (getting started, guides, technical references, deeplinks)

Platform Features

File	What
governance.md	On-chain governance reference
ai-agents.md	ERC-8004, x402 + hosted Celo facilitator, MCP, Agent Skills
security-patterns.md	Celo-specific security risks (pairs with pashov/skills)

Contributing

Data is sourced from official Celo documentation. If you find outdated information:

1. Check 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