Docs are for humans.
Skills are for agents.

Structured instructions. Zero hallucinations.

Step 01

Agent fetches skill

curl llms.txt | or npx skills add

Agent identifies what it needs to build and pulls the right skill file

Step 02

Reads instructions

{ pitfalls, steps, verify }

Gets structured steps, working code, known pitfalls, and verification checks

Step 03

Builds correctly

✓ deployed & verified

Executes with zero hallucinations because every detail is precise and tested

What changes

Before

◌ Agent guesses canister IDs

◌ Hallucinated Motoko syntax

◌ Outdated CLI commands

◌ No idea about cycles or fees

◌ Broken deploys, wasted time

◌ Human has to fix everything

→

After

◆ Exact canister IDs from skill

◆ Tested, working code templates

◆ Current icp-cli commands, verified

◆ Fees and cycles handled correctly

◆ Deploys work first try

◆ Agent ships autonomously

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.

1 paragraph

Prerequisites

icp-cli >= 0.1.0 · Rust or Motoko · Requires: icrc-ledger, wallet

exact versions

⚠ Common Agent Mistakes

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

guardrails

Step-by-step Instructions

1. Add dependencies → 2. Import & configure → 3. Implement deposit flow → 4. Implement transfer → 5. Deploy

tested code

Verification

✓ icp canister call ckbtc_ledger icrc1_balance_of → returns nat · ✓ Transfer returns { Ok: nat }

confirm it works

Any agent, any framework

terminal

# 1. Fetch a skill file directly
curl -sL https://raw.githubusercontent.com/dfinity/icskills/main/skills/ckbtc/SKILL.md

# 2. Or browse and install via skills.sh CLI
npx skills add dfinity/icskills

# 3. Or fetch the full index for agent context
curl -sL https://dfinity.github.io/icskills/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

The first chain agents can actually build on.

Structured skill files that prevent hallucinations. Fetch via llms.txt, raw GitHub URLs, or the skills.sh CLI.

npx skills add dfinity/icskills

Docs are for humans. Skills are for agents.

Docs are for humans.
Skills are for agents.