> ## Documentation Index
> Fetch the complete documentation index at: https://celonames.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Celonames Skill

> An agent skill for registering and managing .celo.eth names on-chain.

This skill teaches your agent how to register, renew, transfer, and manage `.celo.eth` names on Celo Mainnet. It covers availability checks, pricing, record updates, and primary name setup — all via the L2Registrar contracts.

## Install

```bash theme={null}
npx skills add thenamespace/skills --skill celonames
```

## What it covers

* **Availability checks** — look up whether a `.celo.eth` name is registered or free
* **Pricing** — fetch current registration and renewal costs from the L2Registrar
* **Registration** — register a name for a given address and duration
* **Renewals** — extend the expiry of an existing name
* **Transfers** — move ownership of a name to another address
* **Record updates** — set ETH address, avatar, social handles, and custom text records
* **Primary name setup** — configure a reverse record so the name resolves back to a wallet

## How it works

Once installed, the skill gives your agent the context it needs to call the Celo Names contracts directly. It includes:

* Contract addresses for Celo Mainnet
* ABI fragments for the L2Registrar, Controller, and Resolver
* Step-by-step reasoning patterns for each operation
* Error handling guidance (expired names, insufficient funds, invalid labels)

## Example prompts

After installing, your agent can handle prompts like:

> "Check if `alice.celo.eth` is available and tell me the price to register it for 1 year."

> "Register `myagent.celo.eth` to `0xABC...` for 2 years."

> "Set the avatar record for `bob.celo.eth` to `https://example.com/avatar.png`."

> "What is the primary name for `0x1234...`?"

## Links

* [Skill source on GitHub](https://github.com/thenamespace/skills/tree/main/skills/celonames/SKILL.md)