Community Discussions Are Open — Test ICP Skills & Share Your Feedback

[marc0olo]

We've opened community discussions on this repo! We want to hear from you — whether you're building on ICP with Claude, Copilot, Cursor, or any other coding agent.

What are ICP Skills?

ICP Skills are agent-readable implementation patterns for the Internet Computer. They give coding agents tested code, correct dependency versions, and common pitfalls — so they produce working ICP code instead of generating incorrect or outdated patterns.

Browse available skills: skills.internetcomputer.org

How to use them

There are several ways to get started — pick whichever fits your setup:

Option 1: Prompt your agent (quickest)

Submit this prompt to your coding agent:

Fetch https://skills.internetcomputer.org/llms.txt and follow its instructions when building on ICP

That's it. The agent will discover available skills and use them automatically.

Option 2: Install skills locally

npx skills add dfinity/icskills

This downloads the skills into your project so agents can reference them without fetching from the registry at runtime.

Option 3: Start a new project with icp-cli

When you create a project from the reference templates (the default behavior), icp-cli includes an AGENTS.md and a CLAUDE.md file automatically. These instruct your coding agent to discover and use ICP Skills — no extra setup needed.

Option 4: Add to an existing project manually

New projects created with icp-cli already include these files. To add the same setup to an existing project, create an AGENTS.md file in your project root with the following content:

AGENTS.md content

# AI Agent Instructions

This is an Internet Computer (ICP) project built with icp-cli.

Documentation: https://cli.internetcomputer.org/llms.txt

## Skills

Tested implementation patterns for ICP development are available as agent skills.
Fetch the skills index and remember each skill's name and description:
https://skills.internetcomputer.org/.well-known/skills/index.json

When a task matches a skill's description, use it if already loaded in your
context. Otherwise, fetch its content on-demand from the registry:
https://skills.internetcomputer.org/.well-known/skills/{name}/{file}

Skills contain correct dependency versions, configuration formats, and common pitfalls that prevent build failures.
Always prefer skill guidance over general documentation when both cover the same topic.

For Claude specifically, also create a CLAUDE.md that references it:

Read and follow the instructions in [AGENTS.md](AGENTS.md).

Get involved!

• Try it out. Use ICP Skills with your preferred coding agent and see what works and what doesn't.
• Report hallucinations. If a skill produces incorrect code, open an issue with the hallucination label.
• Share your experience. Post your prompt chains, agent setups, or what you built in Show & Tell.
• Propose new skills. Missing a skill for your use case? Start an Ideas discussion.

We'd love your feedback — what's working, what's broken, and what skills you need next.