Skip to content

Commit c80d577

Browse files
committed
put the emdashes back
1 parent 6a07dbb commit c80d577

23 files changed

Lines changed: 214 additions & 214 deletions

File tree

skills/_template/SKILL.md.template

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: <skill-name>
33
description: "<What does this skill do AND when should an agent load it? Include specific keywords. See CONTRIBUTING.md for guidance.>"
44
license: Apache-2.0
5-
compatibility: "<Environment requirements - e.g., icp-cli >= 0.1.0, network access for HTTPS calls>"
5+
compatibility: "<Environment requirements e.g., icp-cli >= 0.1.0, network access for HTTPS calls>"
66
metadata:
77
title: "<Display Name>"
88
category: <CategoryName>
@@ -58,7 +58,7 @@ Brief explanation of the technology. 2-3 sentences max. What does it do? Why doe
5858

5959
<!-- Include working, tested code for each supported language.
6060
Use subsections per language (### Motoko, ### Rust, ### JavaScript).
61-
Show complete file contents - agents copy-paste directly. -->
61+
Show complete file contents agents copy-paste directly. -->
6262

6363
## Deploy & Test
6464

skills/asset-canister/SKILL.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: asset-canister
3-
description: "Deploy frontend assets to the IC. Covers certified assets, SPA routing with .ic-assets.json5, content encoding, and programmatic uploads. Use when hosting a frontend, deploying static files, or setting up SPA routing on IC. Do NOT use for canister-level code patterns or custom domain setup - use custom-domains instead."
3+
description: "Deploy frontend assets to the IC. Covers certified assets, SPA routing with .ic-assets.json5, content encoding, and programmatic uploads. Use when hosting a frontend, deploying static files, or setting up SPA routing on IC. Do NOT use for canister-level code patterns or custom domain setup use custom-domains instead."
44
license: Apache-2.0
55
compatibility: "icp-cli >= 0.2.2, Node.js >= 22"
66
metadata:
@@ -16,7 +16,7 @@ The asset canister hosts static files (HTML, CSS, JS, images) directly on the In
1616

1717
## Prerequisites
1818

19-
- `@icp-sdk/canisters` (>= 3.5.0), `@icp-sdk/core` (>= 5.0.0) - for programmatic uploads
19+
- `@icp-sdk/canisters` (>= 3.5.0), `@icp-sdk/core` (>= 5.0.0) for programmatic uploads
2020

2121
## Canister IDs
2222

@@ -35,7 +35,7 @@ Access patterns:
3535

3636
2. **Missing `.ic-assets.json5` for single-page apps.** Without a rewrite rule, refreshing on `/about` returns a 404 because the asset canister looks for a file literally named `/about`. You must configure a fallback to `index.html`.
3737

38-
3. **Missing or misconfigured `build` in the recipe.** If `configuration.build` is specified, `icp deploy` runs those commands automatically before uploading the `dir` contents. If `build` is omitted, you must run your build command (e.g., `npm run build`) manually before deploying - otherwise the `dir` directory will be stale or empty.
38+
3. **Missing or misconfigured `build` in the recipe.** If `configuration.build` is specified, `icp deploy` runs those commands automatically before uploading the `dir` contents. If `build` is omitted, you must run your build command (e.g., `npm run build`) manually before deploying otherwise the `dir` directory will be stale or empty.
3939

4040
4. **Not setting content-type headers.** The asset canister infers content types from file extensions. If you upload files programmatically without setting the content type, browsers may not render them correctly.
4141

@@ -47,7 +47,7 @@ Access patterns:
4747

4848
8. **Not configuring `allow_raw_access` correctly.** The asset canister has two serving modes: certified (via `ic0.app` / `icp0.io`, where HTTP gateways verify response integrity) and raw (via `raw.ic0.app` / `raw.icp0.io`, where no verification occurs). By default, `allow_raw_access` is `true`, meaning assets are also available on the raw domain. On the raw domain, boundary nodes or a network-level attacker can tamper with response content undetected. Set `"allow_raw_access": false` in `.ic-assets.json5` for any sensitive assets. Only enable raw access when strictly needed.
4949

50-
9. **Downgrading the asset canister WASM version.** Upgrading a canister to an older WASM version can fail with "Cannot parse header" panics if the stable memory format changed between versions. Prefer the `@dfinity/asset-canister` recipe over `type: pre-built` with a manually specified WASM URL - the recipe loads the latest asset canister version automatically if not explicitly specified in `configuration.version`. If you must pin a version, ensure it matches or exceeds the version currently deployed on-chain. If a downgrade is intentional, use reinstall mode (`icp deploy --mode reinstall`) instead of upgrade - this wipes stable memory and all uploaded assets.
50+
9. **Downgrading the asset canister WASM version.** Upgrading a canister to an older WASM version can fail with "Cannot parse header" panics if the stable memory format changed between versions. Prefer the `@dfinity/asset-canister` recipe over `type: pre-built` with a manually specified WASM URL the recipe loads the latest asset canister version automatically if not explicitly specified in `configuration.version`. If you must pin a version, ensure it matches or exceeds the version currently deployed on-chain. If a downgrade is intentional, use reinstall mode (`icp deploy --mode reinstall`) instead of upgrade this wipes stable memory and all uploaded assets.
5151

5252
## Implementation
5353

skills/canhelp/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: canhelp
3-
description: Display a human-readable summary of a canister's interface given its mainnet canister ID or a human-readable name. Like --help but for canisters. Only for mainnet canisters - for local canisters, read the generated .did file in your project directly.
3+
description: Display a human-readable summary of a canister's interface given its mainnet canister ID or a human-readable name. Like --help but for canisters. Only for mainnet canisters for local canisters, read the generated .did file in your project directly.
44
license: Apache-2.0
55
compatibility: "icp-cli >= 0.1.0"
66
allowed-tools: Bash(./scripts/resolve-canister-id.sh *), Bash(./scripts/fetch-candid.sh *), Read, Grep, Glob
@@ -36,7 +36,7 @@ Given a canister ID or name in `$ARGUMENTS`, fetch and summarize its Candid inte
3636
**Canister `<canister-id>`**
3737

3838
**Query methods:**
39-
- `method_name(arg1: type1, arg2: type2) → return_type` - one-line description if inferable from the name
39+
- `method_name(arg1: type1, arg2: type2) → return_type` one-line description if inferable from the name
4040

4141
**Update methods:**
4242
- `method_name(arg1: type1) → return_type`

0 commit comments

Comments
 (0)