AGENT SKILL

crunch-protocol-skill

Natural language interface for Crunch Protocol CLI. Maps user requests to CLI commands for managing coordinators, competitions (crunches), rewards, and checkpoints. Supports output formatting for Slack, Telegram, Discord, or plain text.

License 许可
MIT
最近更新
2026-06-07
Stars
★ 0
Forks
1

01 前言 Front Matter

name
crunch-protocol-skill
description
Natural language interface for Crunch Protocol CLI. Maps user requests to CLI commands for managing coordinators, competitions (crunches), rewards, and checkpoints. Supports output formatting for Slack, Telegram, Discord, or plain text.

03 SKILL.md 正文

Crunch Protocol CLI Skill

This skill translates natural language queries into crunch-cli CLI commands and formats outputs for various mediums.

Setup

Ensure the CLI is installed globally:

npm install -g @crunchdao/crunch-cli

Verify installation:

crunch-cli --version

Profiles

Profiles are stored in profiles.json (next to this file). Each profile maps a short name to a set of CLI flags so users can say things like "list crunches for m-jeremy" instead of typing full addresses every time.

Profile file format

{
  "profiles": {
    "m-jeremy": {
      "url": "https://mainnet.helius-rpc.com/?api-key=...",
      "wallet": "/path/to/keypair.json",
      "multisigAddress": "9WzDXwBbmkg8...",
      "coordinatorWallet": "5abc..."
    },
    "devnet": {
      "url": "devnet",
      "wallet": "/path/to/dev-keypair.json",
      "coordinatorWallet": ""
    }
  }
}

Profile fields → CLI flags

Profile field CLI flag Notes
url -u <value> RPC URL or moniker: mainnet-beta, devnet, testnet, localhost
wallet -w <value> Path to Solana keypair. Only used in multisig mode when the wallet is a proposer.
multisigAddress -m <value> Squads multisig address (not the vault).
coordinatorWallet appended to coordinator get The coordinator owner address. When set, default to this coordinator's context (e.g. listing its crunches).

How to resolve a profile

When a user references a profile name:

  1. Read profiles.json from the skill directory.
  2. Look up the profile by name (case-insensitive match).
  3. Map each non-empty field to its CLI flag (see table above).
  4. Prepend the flags to whatever command is being built.

Example: User says "list crunches for m-jeremy"

  1. Load profile mainnet-proposer → { url: "https://mainnet...", wallet: "/path/...", multisigAddress: "9WzDX..." }
  2. Build: crunch-cli -u "https://mainnet..." -w "/path/..." -m "9WzDX..." crunches list

Example: User says "show coordinator for devnet"

  1. Load profile devnet → { url: "devnet" }
  2. Build: crunch-cli -u devnet coordinator get

Managing profiles

  • Users can ask to add, update, or remove profiles. When they do, read the current profiles.json, apply the change, and write it back.
  • If profiles.json doesn't exist yet, create it with the structure above.
  • When a user says "set profile to m-jeremy" or "use profile m-jeremy", remember it for the rest of the conversation and apply those flags to all subsequent commands automatically.

Command Mapping Rules

IMPORTANT: Direct Phrase Mapping

For speed and consistency, map these phrases directly to CLI commands without LLM interpretation:

User Phrase Pattern CLI Command
get info about crunch <name> crunch-cli crunch get "<name>"
get crunch <name> crunch-cli crunch get "<name>"
show crunch <name> crunch-cli crunch get "<name>"
crunch details <name> crunch-cli crunch get "<name>"
get coordinator <address> crunch-cli coordinator get "<address>"
show coordinator crunch-cli coordinator get
my coordinator crunch-cli coordinator get
list crunches crunch-cli crunches list
list my crunches crunch-cli crunches list
show all crunches crunch-cli crunches list
get config crunch-cli coordinator get-config
coordinator config crunch-cli coordinator get-config
checkpoint for <name> crunch-cli crunch checkpoint-get-current "<name>"
current checkpoint <name> crunch-cli crunch checkpoint-get-current "<name>"
set certificate crunch-cli coordinator cert set
set cert crunch-cli coordinator cert set
update certificate crunch-cli coordinator cert set
get certificate crunch-cli coordinator cert get
get cert crunch-cli coordinator cert get
show certificate crunch-cli coordinator cert get
my certificate crunch-cli coordinator cert get
sweep tokens <name> crunch-cli crunch sweep-token-accounts "<name>"
sweep token accounts <name> crunch-cli crunch sweep-token-accounts "<name>"
check prize accounts <name> crunch-cli crunch check-prize-atas "<name>"
check atas <name> crunch-cli crunch check-prize-atas "<name>"
map cruncher addresses crunch-cli crunch map-cruncher-addresses
emission checkpoint add crunch-cli crunch emission-checkpoint-add

Name Extraction Rules

  • When a crunch name is provided, wrap it in quotes in the CLI command
  • Common competition names: Crunch, Competition, Tournament, Challenge

Execution Pattern

  1. Parse the user request to identify:

    • The action (get, create, start, end, list, etc.)
    • The target (crunch, coordinator, checkpoint, etc.)
    • The name/identifier if applicable
    • Any additional parameters
  2. Map to CLI command using the direct mapping table above

  3. Execute the command:

    crunch-cli [options] <command> [arguments]
    
  4. Format The output of the CLI should be kept as close as possible, except if the user told you to post process the data. But map the output for the specified medium (see Output Formatting below as reference to use)

Available Commands Reference

Coordinator Commands

Command Description Usage
coordinator get [owner] Get coordinator details crunch-cli coordinator get [address]
coordinator get-config Get coordinator configuration crunch-cli coordinator get-config
coordinator register <name> Register new coordinator crunch-cli coordinator register "Name"
coordinator reset-hotkey Reset SMP hotkey crunch-cli coordinator reset-hotkey
coordinator set-emission-config Set emission percentages crunch-cli coordinator set-emission-config <coord%> <staker%> <fund%>

Certificate Commands

Command Description Usage
coordinator cert set <pubkey> [--slot N] Set certificate hash crunch-cli coordinator cert set "MIIBIjAN..." [--slot 0|1]
coordinator cert get [owner] Get certificate info crunch-cli coordinator cert get [address]

Crunch Commands (Competition Management)

Command Description Usage
crunch get <name> Get crunch details crunch-cli crunch get "Synth"
crunches list [wallet] List all crunches crunch-cli crunches list
crunch create Create new crunch crunch-cli crunch create "Name" <payoutUSDC> [maxModels]
crunch start <name> Start competition crunch-cli crunch start "Name"
crunch end <name> End competition crunch-cli crunch end "Name"
crunch deposit-reward Deposit USDC crunch-cli crunch deposit-reward "Name" <amount>
crunch margin <name> Execute margin payout crunch-cli crunch margin "Name"
crunch drain <name> Drain remaining USDC crunch-cli crunch drain "Name"
crunch get-cruncher Get cruncher details crunch-cli crunch get-cruncher "CrunchName" <wallet>
crunch sweep-token-accounts Sweep tokens to vault crunch-cli crunch sweep-token-accounts "Name"
crunch check-prize-atas Check USDC accounts crunch-cli crunch check-prize-atas "Name"
crunch map-cruncher-addresses Map cruncher addresses crunch-cli crunch map-cruncher-addresses "CoordName"
crunch emission-checkpoint-add Add emission checkpoint crunch-cli crunch emission-checkpoint-add "CoordName" <amount>

Checkpoint Commands

Command Description Usage
crunch checkpoint-create Create checkpoint crunch-cli crunch checkpoint-create "Name" prizes.json [--dryrun]
crunch checkpoint-get-current Current checkpoint crunch-cli crunch checkpoint-get-current "Name"
crunch checkpoint-get Get checkpoint by index crunch-cli crunch checkpoint-get "Name" <index>

Global Options

  • -u, --url <network> - Network: mainnet-beta, devnet, localhost (default: from config)
  • -w, --wallet <path> - Wallet keypair file path
  • -o, --output json - Output as JSON (useful for parsing)
  • -m, --multisig <addr> - Create multisig proposal instead of direct execution

Output Formatting

Medium Detection

Detect output medium from user request:

  • "for slack" / "slack format" → Slack
  • "for telegram" / "telegram format" → Telegram
  • "for discord" / "discord format" → Discord
  • Default → Plain text / Markdown

Slack Format

*🏆 Crunch: Synth*
━━━━━━━━━━━━━━━━━
• *Status:* Active
• *Participants:* 142
• *Prize Pool:* 10,000 USDC
• *Checkpoint:* 5
* *Funds:* 3000USDC

Telegram Format

🏆 <b>Crunch: Synth</b>

📊 Status: Active
👥 Participants: 142  
💰 Prize Pool: 10,000 USDC
📍 Checkpoint: 5
💰 Funds: 3000USDC

Discord Format

## 🏆 Crunch: Synth
**Status:** Active
**Participants:** 142
**Prize Pool:** 10,000 USDC
**Checkpoint:** 5

Plain Text / Default

Crunch: Synth
Status: Active
Participants: 142
Prize Pool: 10,000 USDC
Checkpoint: 5
Funds: 3000USDC

Error Handling

If a command fails:

  1. Show user-friendly error message
  2. Suggest possible fixes:
    • Wrong network? Add -u devnet or -u mainnet-beta
    • Missing wallet? Add -w /path/to/wallet.json
    • Crunch not found? List available crunches with crunches list

Example Workflows

"Get me info about crunch Synth"

crunch-cli crunch get "Synth"

"Show my coordinator on mainnet"

crunch-cli -u mainnet-beta coordinator get

"List all crunches for slack"

crunch-cli crunches list

Then format output for Slack.

"What's the current checkpoint for the Chaos competition?"

crunch-cli crunch checkpoint-get-current "Chaos"

Reference Documentation

For full CLI documentation, see references/cli-reference.md.

04 同仓库更多 Skills

javimosch
javimosch/open-claw-skills

crowd-prompting

A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.

★ 0
javimosch
javimosch/open-claw-skills

ceaser

Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir/UltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).

★ 0
javimosch
javimosch/open-claw-skills

ceaser-send

Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir/UltraHonk zero-knowledge proofs.

★ 0
javimosch
javimosch/open-claw-skills

dilemm-ai

Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).

★ 0
javimosch
javimosch/open-claw-skills

moldium

Post and manage content on the Moldium blog platform. Triggered by "post to Moldium", "write a blog post", "publish an article", etc.

★ 0
javimosch
javimosch/open-claw-skills

arxiv-paper-reviews

Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date/category/interest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http://weakaccept.top:8000/.

★ 0