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.
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.
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.
All skills live in skills/*/SKILL.md. Each skill is a self-contained markdown file with YAML frontmatter.
Works with 40+ agents (Claude Code, Cursor, Windsurf, Copilot, and more):
npx skills add dfinity/icskillsBrowse available skills, pick your agent, and install. See skills.sh for details.
Fetch the raw skill file and place it wherever your agent reads instructions from:
curl -sL https://raw.githubusercontent.com/dfinity/icskills/main/skills/ckbtc/SKILL.mdThe files are plain markdown — paste into any system prompt, rules file, or context window.
| Resource | URL | Description |
|---|---|---|
| Skill index | llms.txt |
Short index with links to each skill |
| All skills | llms-full.txt |
All skills concatenated for direct context injection |
| Single skill | https://raw.githubusercontent.com/dfinity/icskills/main/skills/{name}/SKILL.md |
Raw markdown for one skill |
| Agent discovery | .well-known/agent.json |
Machine-readable skill manifest |
| Skill page (HTML) | /skills/{name}/ |
Pre-rendered skill page with full SEO |
| Skill page (MD) | /skills/{name}.md |
Raw markdown served with text/markdown content type |
| CLI | npx skills add dfinity/icskills |
Browse and install skills via skills.sh |
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.
- Site: Astro — static site generator, zero JS by default. Interactive islands with Preact (~18kb gzipped total)
- Hosting: GitHub Pages via Actions
- Skills: Plain markdown files in
skills/*/SKILL.md - Validation: Structural linter for frontmatter and code blocks (
npm run validate) - Schema: JSON Schema for frontmatter at
skills/skill.schema.json - SEO: Per-skill meta tags, JSON-LD (TechArticle), sitemap, canonical URLs
- AI Agent Discovery:
llms.txt,llms-full.txt,.well-known/agent.json, per-skill.mdendpoints
Apache-2.0