Docs are for humans.
Skills are for agents.

Structured instructions that prevent hallucinations. Zero guesswork.

Step 01

The problem

mxzaz-hqaaa... ← hallucinated

AI agents guess canister IDs, use deprecated APIs, and miss ICP-specific details like subaccounts and cycle fees.

Step 02

The right skill

curl .../skills/ckbtc/SKILL.md

The agent matches the task to a skill via description, fetches it, and gets correct canister IDs, tested code, pitfalls, and verification steps.

Step 03

The result

icp canister call icrc1_balance_of

The agent builds with accurate context and verifies its own work. Working code on the first deploy.

Anatomy of a skill

What This Is

ckBTC is chain-key Bitcoin on the Internet Computer. This skill covers accepting deposits, sending transfers, checking balances, and minting.

context

Prerequisites

ic-cdk >= 0.19 · icrc-ledger-types >= 0.1 · candid >= 0.10

exact versions

Common Pitfalls

DO NOT use pre-2025 minter canister ID (it changed) · DO NOT forget the 10 sat fee · DO NOT skip subaccounts for deposits

guardrails

Plus implementation steps, deploy instructions, and verification checks — tailored to each integration.

Any agent, any framework

terminal

# 1. Discover all skills (Agent Skills Discovery RFC)
curl -sL https://skills.internetcomputer.org/.well-known/skills/index.json

# 2. Fetch a single skill file
curl -sL https://skills.internetcomputer.org/.well-known/skills/ckbtc/SKILL.md
# or via GitHub raw:
curl -sL https://raw.githubusercontent.com/dfinity/icskills/main/skills/ckbtc/SKILL.md

# 3. Or fetch all skills at once for full context injection
curl -sL https://skills.internetcomputer.org/llms-full.txt

# Agent now knows:
# - Correct canister ID: mxzaz-hqaaa-aaaar-qaada-cai
# - Fee is 10 satoshis (not 0)
# - Must use subaccounts for deposits

# → Deploys correctly on first try
# → Runs verification checks
# → Ships autonomously

Claude

Skills as context

ChatGPT

Function calling

Cursor

Rules files

Devin

Knowledge base

Copilot

Custom instructions

Windsurf

Cascade context

Claude Code

SKILL.md files

OpenCode

Remote instructions

OpenClaw

Skills marketplace

skills.sh

npx skills add

Give your agent the context it needs.

Every IC integration, one fetch away. Works with any agent or framework.

npx skills add dfinity/icskills

Docs are for humans.Skills are for agents.

Docs are for humans.
Skills are for agents.