Agent Skills

npx openskills install celo-org/agent-skills -g

npx openskills install celo-org/agent-skills --skill evm-hardhat -g

# 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

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-name/
├── SKILL.md           # Main instructions (required)
├── references/        # Detailed documentation
├── rules/             # Best practices and standards
└── scripts/           # Executable scripts

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

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

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

// 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,
    },
  },
};

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
});

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],
});

mkdir -p ~/.claude/skills/my-custom-skill

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

my-custom-skill/
├── SKILL.md
├── references/
│   └── api-docs.md
├── rules/
│   └── best-practices.md
└── scripts/
    └── helper.py