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.

Chain Migration

Move or expand an existing EVM app onto Celo from another L2 (Lisk, Base, Optimism, Mode, Ink, Unichain, Soneium, Zora, Fraxtal). Audits the repo for chain IDs, RPC hosts, and hardcoded token addresses, then maps tokens and protocols and applies the edits. Covers the two changes that silently break working code: the gas token (ETH → CELO, plus CIP-64 fee abstraction) and CELO token duality — where ported WETH.deposit() reverts, receive() never fires on the ERC-20 path, and a CELO approval exposes the user's gas balance.

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"
• "I'm building on Lisk — how do I move my app to Celo?"
• "Report a bug / request a feature" — the skill routes it to the right Celo repo and files a GitHub issue (or a PR for small doc/reference fixes)

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; 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
dev-methodology.md	Spec-driven development: working with AI coding agents on Celo projects
migrating-from-another-chain.md	Move a dApp to Celo from another L2: repo audit, token/protocol mapping, gas token + duality breaks

DeFi

File	What
defi-protocols.md	Deep protocol reference (Uniswap, Aave, Carbon DeFi, Morpho, Mento) with live APY fetching
stablecoin-orchestration.md	Fiat ↔ stablecoin rails via Bridge (Stripe): virtual accounts, payouts, cards, issuance

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)
minipay-app-fit.md	Should you target MiniPay? Product-channel fit scorecard and category opportunity map
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-performance.md	Measure and optimize Mini App load speed against the listing requirement
minipay-docs-map.md	Page-by-page index of docs.minipay.xyz (getting started, guides, technical references, deeplinks)

Builder Toolkit

Non-protocol problems — the things that stall a project after the code works.

File	What
growth-diagnostic.md	Entry point: "where are you stuck?" — routes to the right toolkit file
growth-gtm.md	Go-to-market for Celo and MiniPay audiences: ICP, channels, launch sequencing
growth-comms.md	Narrative, build-in-public cadence, launch-grade content
growth-ux-design.md	UX and design differentiation; MiniPay copy rules
growth-referrals.md	Referral loops, dual-sided incentives, anti-sybil
growth-analytics.md	On-chain and off-chain measurement: RPC, The Graph, PostHog
growth-seo.md	SEO playbook with country-specific worked examples
business-model.md	Designing a revenue layer: commissions, subscriptions, capturing stablecoin flow

Brand & Attribution

File	What
brandkit.md	Official Celo brand kit: logo usage, naming, what needs permission
attribution-tags.md	Attribution tags (ERC-8021) — tag transactions for impact tracking & future rewards

Platform Features

File	What
governance.md	On-chain governance reference
ai-agents.md	ERC-8004, x402 + hosted Celo facilitator, MCP, Agent Skills
self-agent-id.md	Self Agent ID: proof-of-human on ERC-8004, soulbound NFT on Celo
security-patterns.md	Celo-specific security risks (pairs with pashov/skills)
feedback.md	Route bug reports / feature requests to the right Celo repo and file via gh

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