# CCC Agent Skills (CKB / CCC development)

> Modular, machine-readable operating guidance for AI coding assistants building on CKB with the CCC SDK. Each skill below is a directory with a SKILL.md (YAML frontmatter + Markdown body), following the Agent Skills format (https://agentskills.io/specification).

## Install

If your tool/agent can run a shell command, install with the [`skills` CLI](https://github.com/vercel-labs/skills) (supports Cursor, Claude Code, GitHub Copilot, Windsurf, Codex, and 60+ other agents — auto-discovers the `skills/` directory and writes each skill to the right path for your tool):

```bash
npx skills add ckb-devrel/ccc --all
```

If your tool/agent can only fetch URLs (no shell access — browser-based agents, plain chat models, etc.), fetch the raw `SKILL.md` files directly from the table below. Always fetch `ckb-ccc-fundamentals` first, then the spoke skill matching the task.

## Notes for AI agents

- Always load `ckb-ccc-fundamentals` first — it's the hub skill; every spoke skill assumes it's already loaded.
- Then load the spoke skill(s) matching the task at hand — see the table below, or each skill's own `description` frontmatter field for exactly when to use it.
- Tools that natively support multiple skill files/directories (e.g. Claude Code) should fetch the whole `skills/` directory at once.
- Tools that only support a single rule/context file should load `ckb-ccc-fundamentals` as the default and fetch additional skill URLs on demand, per the task.
- Raw file URLs below always reflect the latest version on the `master` branch.
- Full docs: https://docs.ckbccc.com — docs index: https://docs.ckbccc.com/llms.txt — API reference: https://api.ckbccc.com

## Skills

| Skill | Role | Depends on | SKILL.md |
| --- | --- | --- | --- |
| `ckb-ccc-fundamentals` | hub | none | https://raw.githubusercontent.com/ckb-devrel/ccc/refs/heads/master/skills/ckb-ccc-fundamentals/SKILL.md |
| `ckb-ccc-signer-setup` | spoke | ckb-ccc-fundamentals | https://raw.githubusercontent.com/ckb-devrel/ccc/refs/heads/master/skills/ckb-ccc-signer-setup/SKILL.md |
| `ckb-ccc-transactions` | spoke | ckb-ccc-fundamentals, ckb-ccc-signer-setup | https://raw.githubusercontent.com/ckb-devrel/ccc/refs/heads/master/skills/ckb-ccc-transactions/SKILL.md |
| `ckb-ccc-udt` | spoke | ckb-ccc-fundamentals, ckb-ccc-transactions | https://raw.githubusercontent.com/ckb-devrel/ccc/refs/heads/master/skills/ckb-ccc-udt/SKILL.md |
| `ckb-ccc-spore` | spoke | ckb-ccc-fundamentals, ckb-ccc-transactions | https://raw.githubusercontent.com/ckb-devrel/ccc/refs/heads/master/skills/ckb-ccc-spore/SKILL.md |
| `ckb-ccc-playground` | spoke | ckb-ccc-fundamentals, ckb-ccc-transactions | https://raw.githubusercontent.com/ckb-devrel/ccc/refs/heads/master/skills/ckb-ccc-playground/SKILL.md |
| `ckb-ccc-examples-finder` | spoke | ckb-ccc-fundamentals | https://raw.githubusercontent.com/ckb-devrel/ccc/refs/heads/master/skills/ckb-ccc-examples-finder/SKILL.md |

## Skill summaries

### ckb-ccc-fundamentals

Cell model, package selection, address handling, Shannon/CKB amount conversion, the KnownScript enum, and how to look up exact API signatures (DeepWiki/Context7/api.ckbccc.com) or navigate docs.ckbccc.com. Load this first for any CKB/CCC task.

### ckb-ccc-signer-setup

Connecting a wallet in a React/Next.js dApp, or creating a private-key Signer in a Node.js backend; the supported wallet matrix; message signing/verification.

### ckb-ccc-transactions

Composing and sending CKB transactions — outputs, completeInputsByCapacity/completeFeeBy ordering, cell deps, and querying the chain. The base pattern ckb-ccc-udt and ckb-ccc-spore build on.

### ckb-ccc-udt

Issuing (Single-Use-Seal), transferring, and reading metadata for UDT/xUDT fungible tokens.

### ckb-ccc-spore

Creating, transferring, and melting Spore protocol NFTs/DOBs, including cluster handling and the DOB/0 + DOB/1 content-type conventions.

### ckb-ccc-playground

The CCC Playground (live.ckbccc.com) — the @ckb-ccc/playground module, UI controls, and the two ways to share runnable code.

### ckb-ccc-examples-finder

Locating existing, ready-made CKB/CCC example code by category instead of writing something from scratch or guessing at patterns.