Skip to content

refactor: consolidate skills — fix compatibility, descriptions, and dfx references#82

Merged
marc0olo merged 4 commits intomainfrom
marc0olo/consolidate-skills
Mar 10, 2026
Merged

refactor: consolidate skills — fix compatibility, descriptions, and dfx references#82
marc0olo merged 4 commits intomainfrom
marc0olo/consolidate-skills

Conversation

@marc0olo
Copy link
Member

@marc0olo marc0olo commented Mar 9, 2026

Summary

  • Compatibility vs Prerequisites: Separated environment tools (icp-cli, Node.js) from library dependencies across all 16 skills. Standardized Node.js >= 24.
  • Skill descriptions: Enriched all descriptions with "Use when..." / "Do NOT use for..." triggering clauses for better agent routing.
  • Rename wallet → cycles-management: The old name was misleading — the skill covers cycles and canister lifecycle, not wallet integration.
  • icp.yaml configs: Converted all dfx-format configs to proper icp-cli recipe syntax (@dfinity/motoko@v4.1.0, @dfinity/rust@v3.2.0, @dfinity/asset-canister@v2.1.0).
  • Port 4943 → 8000: Replaced all localhost:4943 (dfx default) with localhost:8000 (icp-cli default).
  • dfx → icp commands: Fixed dfx starticp network start -d in wallet-integration and internet-identity.
  • internet-identity: Replaced legacy CANISTER_ID_* env var pattern with ic_env cookie / PUBLIC_CANISTER_ID: pattern.
  • evm-rpc: Replaced dfx-specific type: pull / type: custom with pre-built WASM pattern (validated against feat: add icp-cli support to rust/evm_block_explorer examples#1310).
  • vetkd: Removed dfx_test_key references, recommend test_key_1 (works both locally and on mainnet).
  • cycles-management: Fixed CLI commands (--icp for mint, --cycles for create, canister status instead of canister info).
  • icp-cli: Added installation section, bumped Node.js to >= 24.

All CLI commands verified against icp-cli source (clap Args structs). All 16 skills pass validation.

Supersedes #66 — those icp-cli prerequisite lines have been removed entirely (moved to the compatibility frontmatter field).

Closes #70

Related: #74 (wallet renamed + improved, redundancy question still open), #73 (vetkd key names fixed, full accuracy review still pending), #72 (sns-launch dfx moved to compatibility, content accuracy still pending)

…riptions, and dfx references

- Separate compatibility (env tools) from prerequisites (library deps) across all 16 skills
- Move icp-cli and Node.js from prerequisites to compatibility where needed
- Standardize Node.js >= 24 across all skills requiring it
- Enrich all skill descriptions with "Use when..." / "Do NOT use for..." triggering clauses
- Rename wallet skill to cycles-management (fixes misleading name)
- Convert all dfx-format icp.yaml configs to proper recipe syntax
- Replace all localhost:4943 references with localhost:8000 (icp-cli default)
- Replace dfx commands with icp equivalents in wallet-integration and internet-identity
- Fix internet-identity to use ic_env cookie pattern instead of legacy CANISTER_ID_* env vars
- Fix evm-rpc config to use pre-built WASM pattern (validated against dfinity/examples#1310)
- Remove dfx_test_key references from vetkd, recommend test_key_1 (works locally + mainnet)
- Fix cycles-management CLI commands: --icp for mint, --cycles for create, canister status
- Add icp-cli installation section
- Remove stale canister_ids.json references (icp-cli uses .icp/data/mappings/)
- Lower Node.js requirement from >= 24 to >= 22 (active LTS) across all skills
- Remove Node.js from compatibility where it's not a hard requirement
  (icp-cli, certified-variables, vetkd) — keep it only for frontend-focused
  skills (asset-canister, internet-identity, wallet-integration)
- Remove redundant Node.js prerequisite from icp-cli (already in Installation)
@marc0olo marc0olo requested a review from raymondk March 10, 2026 09:27
@marc0olo marc0olo merged commit 43ad111 into main Mar 10, 2026
6 checks passed
@marc0olo marc0olo deleted the marc0olo/consolidate-skills branch March 10, 2026 16:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

innacurate use of icp-cli in evm-rpc examples

2 participants