Internet Computer (ICP) Skills

Under active development — Skill files are being reviewed and signed off by DFINITY engineers. Content may change. Feedback and PRs are welcome.

Agent-readable instructions for every IC need.

Structured, agent-readable skill files for every Internet Computer capability. Your AI reads the skill. It builds correctly. No hallucinations.

The Problem

AI agents building on the Internet Computer hallucinate canister IDs, use deprecated APIs, and miss critical pitfalls. Traditional documentation is written for humans to browse — not for agents to consume programmatically.

The Solution

Each skill is a single markdown file containing everything an agent needs to build correctly:

skills/ckbtc/SKILL.md
skills/internet-identity/SKILL.md
skills/stable-memory/SKILL.md
...

Every skill typically includes:

Section	Purpose
What This Is	One paragraph. What the technology does.
Prerequisites	Exact library versions. `ic-cdk >= 0.19`, `@icp-sdk/auth >= 4.0.1`.
Common Pitfalls	Numbered pitfalls that prevent hallucinations.
Implementation	Tested, copy-paste-correct code blocks.
Deploy & Test	Step-by-step commands for local and mainnet.
Verify It Works	Concrete commands to confirm it works.

Skills can include additional sections (Canister IDs, How It Works, etc.) and use whatever headings best fit their domain. The pitfalls section is the highest-value part — every pitfall documented is a hallucination prevented.

Skills

All skills live in skills/*/SKILL.md. Each skill is a self-contained markdown file with YAML frontmatter.

Usage

Install via CLI

Works with any agent that supports skills (Claude Code, Cursor, Windsurf, Copilot, and more):

npx skills add dfinity/icskills

Browse available skills, pick your agent, and install. See skills.sh for details.

Manual

Fetch a single skill and place it wherever your agent reads instructions from:

curl -sL https://skills.internetcomputer.org/.well-known/skills/ckbtc/SKILL.md

The files are plain markdown — paste into any system prompt, rules file, or context window.

Programmatic Access

Resource	URL	Description
Skills discovery	`.well-known/skills/index.json`	Machine-readable skill index (Agent Skills Discovery RFC)
Single skill	`/.well-known/skills/{name}/SKILL.md`	Raw markdown for one skill
Reference files	`/.well-known/skills/{name}/references/{file}.md`	Additional files listed in the discovery index
Download (zip)	`/.well-known/skills/{name}/SKILL.zip`	Zip bundle for multi-file skills (SKILL.md + references)
Skill index	`llms.txt`	All skills with descriptions and discovery links
Skill page	`/skills/{name}/`	Pre-rendered skill page for humans

Evaluations

Each skill can have an evaluation file at evaluations/<skill-name>.json that tests whether agents produce correct output with the skill loaded. Evals compare agent output with and without the skill, using an LLM judge to score expected behaviors.

node scripts/evaluate-skills.js <skill-name>                    # All evals
node scripts/evaluate-skills.js <skill-name> --eval 2            # Single eval
node scripts/evaluate-skills.js <skill-name> --no-baseline       # Skip without-skill baseline
node scripts/evaluate-skills.js <skill-name> --triggers-only     # Trigger evals only

Results are saved to evaluations/results/ (gitignored). See CONTRIBUTING.md for how to write eval cases and prompts.

Contributing

See CONTRIBUTING.md for how to add or update skills.

All PRs require repo admin approval. One skill per PR. Code examples must be tested.

Tech Stack

Site: Astro — static site generator, zero JS by default. Interactive islands with Preact (~18kb gzipped total)
Hosting: IC asset canister at skills.internetcomputer.org
Skills: Plain markdown files in skills/*/SKILL.md
Validation: skill-validator for structure, links, content analysis, and contamination checks (npm run validate)
Evaluation: Per-skill eval cases with LLM-as-judge scoring (node scripts/evaluate-skills.js <skill>)
Schema: JSON Schema for frontmatter at skills/skill.schema.json
SEO: Per-skill meta tags, JSON-LD (TechArticle), sitemap, canonical URLs
Skills Discovery: llms.txt, .well-known/skills/ (Skills Discovery RFC)

License

Apache-2.0