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 any agent that supports skills (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 a single skill and place it wherever your agent reads instructions from:
curl -sL https://skills.internetcomputer.org/.well-known/skills/ckbtc/SKILL.mdThe files are plain markdown — paste into any system prompt, rules file, or context window.
| 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 |
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: IC asset canister at
skills.internetcomputer.org - Skills: Plain markdown files in
skills/*/SKILL.md - Validation: Structural linter for frontmatter and code blocks (
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)
Apache-2.0