功能描述

Use when managing Crunch coordinators, competitions (crunches), rewards, checkpoints, staking, or cruncher accounts via the crunch-cli.

使用说明 (SKILL.md)

Crunch Protocol CLI Skill

Name: Crunch Coordinate
Author: philippwassibauer

Translates natural language queries into crunch-cli commands. Supports profiles and output formatting for Slack, Telegram, Discord, or plain text.

Prerequisites

Node.js 18+ with npm
Solana wallet keypair (for on-chain operations)

Package Installation

This skill installs packages via npm (global):

Package	Source	Purpose
`@crunchdao/crunch-cli`	npm	CrunchDAO protocol CLI (coordinators, competitions, staking)

Agent rules for package installation:

Only install @crunchdao/crunch-cli from the official npm registry
No custom registry URLs — no --registry overrides
Ask the user before installing if not already present

Credentials

Solana Wallet Keypair (required for on-chain operations)

What it is: A JSON file containing a Solana private key, used to sign transactions
How it's configured: Set via crunch-cli config set wallet /path/to/wallet.json or -w flag per command
Stored in: User-managed file on disk; path referenced in ~/.crunch/config.json

Agent rules for wallets:

Never create or generate wallet keypairs unless the user explicitly asks and understands the security implications
Never read or display the contents of wallet keypair files
Never commit wallet files to git — always verify .gitignore covers them
Ask the user for the wallet path — never assume or search for keypair files

Profile Config (`~/.crunch/config.json`)

Stores network, wallet path, and RPC URL per profile
Managed via crunch-cli config commands — no need to edit manually
Never modify or delete existing profiles unless explicitly asked

Setup

npm install -g @crunchdao/crunch-cli
crunch-cli --version

Profiles

The CLI has built-in profile management via ~/.crunch/config.json:

crunch-cli config show                    # Show current config
crunch-cli config active                  # Show resolved active values
crunch-cli config list-profiles           # List available profiles
crunch-cli config save-profile \x3Cname>     # Save current config as profile
crunch-cli config use \x3Cprofile>           # Switch profile
crunch-cli config set \x3Ckey> \x3Cvalue>       # Set config value

Global flags can override config per-command:

Flag	Description
`-n, --network`	Solana network: `mainnet-beta`, `devnet`, `localhost`
`-u, --url`	Custom RPC URL
`-w, --wallet`	Path to Solana keypair
`-o, --output`	Output format: `json`, `table`, `yaml`

Direct Phrase Mapping

User Phrase	CLI Command
`get/show crunch \x3Cname>`	`crunch-cli crunch get "\x3Cname>"`
`list crunches`	`crunch-cli crunch list`
`get/show coordinator [address]`	`crunch-cli coordinator get [address]`
`list coordinators`	`crunch-cli coordinator list`
`get config`	`crunch-cli coordinator get-config`
`checkpoint for \x3Cname>`	`crunch-cli crunch checkpoint-get-current "\x3Cname>"`
`create checkpoint \x3Cname>`	`crunch-cli crunch checkpoint-create "\x3Cname>" prizes.json`
`deposit reward \x3Cname> \x3Camount>`	`crunch-cli crunch deposit-reward "\x3Cname>" \x3Camount>`
`drain \x3Cname>`	`crunch-cli crunch drain "\x3Cname>"`
`create/register cruncher`	`crunch-cli cruncher create`
`register for \x3Cname>`	`crunch-cli cruncher register "\x3Cname>"`
`claim rewards \x3Cname>`	`crunch-cli cruncher claim "\x3Cname>"`
`show staking positions`	`crunch-cli staking positions`
`stake/deposit \x3Camount>`	`crunch-cli staking deposit \x3Camount>`
`delegate to \x3Ccoordinator>`	`crunch-cli staking delegate "\x3Ccoordinator>" \x3Camount>`
`show staking rewards`	`crunch-cli staking rewards`
`claim staking rewards`	`crunch-cli staking claim`
`undelegate from \x3Ccoordinator>`	`crunch-cli staking undelegate "\x3Ccoordinator>" \x3Camount>`
`withdraw stake \x3Camount>`	`crunch-cli staking withdraw \x3Camount>`
`init workspace \x3Cname>`	`crunch-cli init-workspace "\x3Cname>"`
`list scenarios/simulations`	`crunch-cli model list`
`run simulation \x3Cscenario>`	`crunch-cli model run "\x3Cscenario>"`
`register coordinator \x3Cname>`	`crunch-cli coordinator register "\x3Cname>"`
`create crunch \x3Cname>`	`crunch-cli crunch create "\x3Cname>" \x3Camount> [maxModels]`
`start/end crunch \x3Cname>`	`crunch-cli crunch start/end "\x3Cname>"`

Execution Pattern

Parse — Identify action, target, name/identifier, parameters
Resolve profile — If mentioned, switch profile or use flags
Map — Use phrase mapping table
Execute — Run command
Format — Output for requested medium (Slack/Telegram/Discord/plain)

Output Formatting

Detect medium from user request ("for slack", "telegram format", etc.):

Slack: *bold*, • bullets, ━ separators
Telegram: \x3Cb>bold\x3C/b>, emoji prefixes
Discord: ## headers, **bold**
Plain: Simple key: value pairs

Error Handling

If command fails, suggest fixes:

Wrong network? Add -n mainnet-beta or -n devnet
Missing wallet? Add -w /path/to/wallet.json
Not found? List available with crunch-cli crunch list

Coordinator Node Setup

Scaffold a new competition workspace:

crunch-cli init-workspace my-challenge

This generates a full node workspace. See the coordinator-node-starter skill for customization.

Reference

For full CLI documentation: references/cli-reference.md

安全使用建议

This skill appears to do what it says: translate user prompts into crunch-cli commands. Before installing or using it: 1) Verify the npm package @crunchdao/crunch-cli on the official npm site (author, weekly downloads, repository) to ensure you’re installing the intended project. 2) Confirm the Python package mention (pip install crunch-cli) — it may be a separate package required only for model/simulation commands; only install if you need those features. 3) Keep your Solana wallet keypair private: supply the wallet path explicitly when asked, and do not let the agent search for or reveal the file. 4) Require explicit user confirmation for any command that deposits, withdraws, stakes, delegates, or otherwise moves funds; consider testing on devnet first (use -n devnet and --dry-run) to avoid accidental financial transactions. 5) Prefer to run installations yourself (npm install -g) rather than granting the agent permission to install global packages automatically.

功能分析

Type: OpenClaw Skill Name: crunch-coordinate Version: 0.1.1 The skill bundle is designed to manage the Crunch Protocol via its `crunch-cli` tool. While the underlying CLI performs sensitive operations involving cryptocurrency wallets and funds, the `SKILL.md` contains explicit, robust 'Agent rules' that instruct the AI agent to handle credentials securely (e.g., 'Never read or display the contents of wallet keypair files', 'Ask the user for the wallet path') and restrict package installation. There is no evidence of intentional malicious behavior, data exfiltration, obfuscation, or prompt injection attempts designed to harm the user or the system. The documented commands and instructions are consistent with the stated purpose of managing a blockchain protocol.

能力评估

✓ Purpose & Capability

Name/description (manage Crunch coordinators/competitions/staking via crunch-cli) matches the runtime instructions: it maps natural language to crunch-cli commands and expects the @crunchdao/crunch-cli npm package and a Solana wallet keypair for on-chain operations. No unrelated credentials or system-wide access are requested.

ℹ Instruction Scope

Instructions are narrowly scoped to generating and executing crunch-cli commands and managing ~/.crunch/config.json via the CLI. The skill explicitly forbids reading/displaying wallet keypair files and searching the filesystem for wallets, which is good. Note: the agent will run CLI commands that themselves access wallet files and network RPCs to sign/send transactions — this is expected for on-chain operations but means the agent can trigger real financial actions if allowed to execute commands.

ℹ Install Mechanism

There is no built-in install spec in the registry bundle (instruction-only). The SKILL.md directs global npm install of @crunchdao/crunch-cli (official npm registry) which is proportionate. It also notes a Python package for model commands (pip install crunch-cli) — this dual Node/Python packaging is plausible but worth verifying (two different packages named similarly). No downloads from unknown URLs or archive extraction are present.

✓ Credentials

The skill requests no environment variables or external secrets. It legitimately requires a user-controlled Solana wallet keypair file and uses ~/.crunch/config.json for profiles; both are proportional to the CLI’s purpose. The SKILL.md's admonition to never read/display wallet contents is appropriate. Confirm the agent will only use the wallet path you provide and will ask before installing or performing on-chain transactions.

✓ Persistence & Privilege

The skill is instruction-only, does not request always:true, and does not modify other skills or system-wide settings. Autonomous invocation is allowed (platform default) — note that this means the agent could autonomously run commands that perform transactions if given permission, so consider restricting autonomous capabilities or requiring user confirmation for financial actions.

版本历史

v0.1.1

- Added dedicated "Prerequisites" and "Credentials" sections, clarifying Node.js, npm, package installation rules, and Solana wallet requirements. - Defined agent guidance for installing packages and handling wallet keypairs, emphasizing security and explicit user consent. - Expanded instructions for credential and profile management. - Clarified rules around never reading, displaying, or creating wallet files unless explicitly asked. - Minor updates to coordinator node setup and formatting for consistency.

v0.1.0

crunch-coordinate v0.1.0 - Initial release with natural language to `crunch-cli` command translation. - Supports profile management and output formatting for Slack, Telegram, Discord, and plain text. - Provides direct phrase-to-command mapping for common Crunch Protocol tasks. - Includes setup instructions and usage examples for managing coordinators, competitions, staking, and rewards. - Suggests troubleshooting steps for typical CLI errors.

元数据

Slug crunch-coordinate

版本 0.1.1

许可证 —

累计安装 0

当前安装数 0

历史版本数 2

常见问题

Crunch Coordinate 是什么？

Use when managing Crunch coordinators, competitions (crunches), rewards, checkpoints, staking, or cruncher accounts via the crunch-cli. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 737 次。

如何安装 Crunch Coordinate？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install crunch-coordinate」即可一键安装，无需额外配置。

Crunch Coordinate 是免费的吗？

是的，Crunch Coordinate 完全免费（开源免费），可自由下载、安装和使用。

Crunch Coordinate 支持哪些平台？

Crunch Coordinate 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Crunch Coordinate？

由 philippWassibauer（@philippwassibauer）开发并维护，当前版本 v0.1.1。

Crunch Coordinate