dfinity/icskills

canhelp

Display a human-readable summary of a canister's interface given its mainnet canister ID or a human-readable name.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/dfinity/icskills --skill canhelp

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Given a canister ID or name in $ARGUMENTS, fetch and summarize its Candid interface.

Steps

  1. Resolve the canister ID by running the resolve script from the skill's base directory:
bash
   ./scripts/resolve-canister-id.sh "$ARGUMENTS"

If $ARGUMENTS is already a valid principal, the script echoes it back. Otherwise, it queries the IC Dashboard API and outputs matches as <canister-id> <name> (one per line).

  • If there is a single result, clearly display the resolved canister ID and use it directly.
  • If there are multiple results, present the list to the user and ask them to pick one before continuing.
  1. Fetch the Candid interface using the resolved canister ID:
bash
   ./scripts/fetch-candid.sh <resolved-canister-id>

The script outputs the path to the downloaded .did file.

  1. Read the file using the Read tool.
  1. Present the output as a readable summary with the following structure:

Canister `<canister-id>`

Query methods:

  • method_name(arg1: type1, arg2: type2) → return_type — one-line description if inferable from the name

Update methods:

  • method_name(arg1: type1) → return_type

Types:

  • List any custom record/variant types defined in the interface, with their fields

Guidelines

  • Group methods by query vs update
  • Sort methods alphabetically within each group
  • For complex nested types, show the top-level structure and note nesting
  • If the candid is very large (>100 methods), show a summary count and list only the most important-looking methods, offering to show the full list on request
  • If the fetch succeeds, but the Candid interface is empty,explain that the canister is not exposing its Candid interface in the wasm metadata
  • If the fetch fails, suggest the user verify the canister ID and that icp is installed
from this repository

More skills

All skills
dfinity
Community

autoupgrade-icp-cli

One-time installer that keeps a project's Internet Computer CLI toolchain current. Sets up a SessionStart hook plus a script that compares the installed icp and ic-wasm against the latest release and either reports the upgrade or applies it, using whichever channel each tool was installed from (npm, Homebrew, or the shell installer). Use when a user wants to install, bootstrap, or enable automatic icp-cli / ic-wasm updates, asks to stop running an outdated icp, asks how to upgrade or check the v

1h installs
1
GitHub stars
39
Updated
Nov 11
dfinity
Community

buy-cycles

Buy cycles with a credit card for the CLI's own identity with icp cycles buy, through CyclePay's on-chain gateway, then continue deploying. Use when a mainnet deploy or canister creation fails for lack of cycles, the user has no ICP, no wallet or no exchange account, or asks to pay for cycles by card, Stripe, fiat or USD. Do NOT use for converting ICP you already hold (cycles-management: icp cycles mint), for topping up a canister from an existing balance, or for Internet Identity sign-in (agent

1h installs
1
GitHub stars
39
Updated
Nov 11
dfinity
Community

canister-security

IC-specific security patterns for canister development in Motoko and Rust. Covers access control, anonymous principal rejection, reentrancy prevention (CallerGuard pattern), async safety (saga pattern), callback trap handling, cycle drain protection, and safe upgrade patterns. Use when writing or modifying any canister that modifies state, handles tokens, makes inter-canister calls, or implements access control.

1h installs
1
GitHub stars
39
Updated
Nov 11
dfinity
Community

ckbtc

Accept, send, and manage ckBTC (chain-key Bitcoin). Covers BTC deposit flow via minter, ckBTC transfers, withdrawal to BTC, subaccount derivation, and UTXO management. Use when integrating Bitcoin, ckBTC, BTC deposits, or BTC withdrawals in a canister. Do NOT use for plain token transfers without BTC minting/withdrawal — use icrc-ledger instead.

1h installs
1
GitHub stars
39
Updated
Nov 11