# Send Crunch Compete to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "crunch-compete",
    "name": "Crunch Compete",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/philippWassibauer/crunch-compete",
    "canonicalUrl": "https://clawhub.ai/philippWassibauer/crunch-compete",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/crunch-compete",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=crunch-compete",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/cli-reference.md",
      "references/competition-setup.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/crunch-compete"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/crunch-compete",
    "downloadUrl": "https://openagent3.xyz/downloads/crunch-compete",
    "agentUrl": "https://openagent3.xyz/skills/crunch-compete/agent",
    "manifestUrl": "https://openagent3.xyz/skills/crunch-compete/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/crunch-compete/agent.md"
  }
}
```
## Documentation

### Cruncher Skill

Guides users through Crunch competition lifecycle: setup, quickstarter discovery, solution development, local testing, and submission.

### Prerequisites

Python 3.9+ with venv module (included in standard Python)
pip for package installation

### Package Installation

This skill installs Python packages from PyPI into isolated virtual environments:

PackageSourcePurposecrunch-cliPyPICrunchDAO competition CLI (setup, test, submit)jupyterPyPINotebook support (optional)ipykernelPyPIJupyter kernel registration (optional)Competition SDKs (e.g. crunch-synth, birdgame)PyPICompetition-specific libraries (varies)

Agent rules for package installation:

Always use a virtual environment — never install into system Python
Only install known packages listed above or referenced in competition docs (PACKAGES.md)
Ask the user before installing any package not listed here
All packages are from PyPI — no custom URLs, no --index-url overrides, no .whl files from unknown sources

### Submission Token (required for setup & submit)

How to get: User logs into CrunchDAO Hub, navigates to the competition's submit page (/competitions/<competition>/submit), and copies their token
How it's used: Passed once via --token <TOKEN> during crunch setup
Persistence: After setup, the CLI stores the token in the project's .crunch/ config directory. All subsequent commands (crunch test, crunch push, crunch download) authenticate automatically — no need to pass the token again
If token expires: Run crunch update-token inside the project directory to refresh it

Agent rules for tokens:

Always ask the user to provide the token — never assume, guess, or reuse tokens from other projects
Never write tokens into source files, scripts, notebooks, or any committed file
Never log or echo tokens in shell output (use --token <TOKEN> placeholder in examples shown to user)
Tokens are user-specific and project-scoped — each crunch setup call requires the user to supply one

### GitHub API (optional, unauthenticated)

Used only for browsing quickstarter listings via api.github.com (public repo, no auth needed)
Rate-limited to 60 requests/hour per IP; sufficient for normal use

### Network Access

OperationRequires networkEndpointcrunch setupYeshub.crunchdao.comcrunch pushYeshub.crunchdao.comcrunch downloadYeshub.crunchdao.comcrunch testNoLocal onlycrunch listYeshub.crunchdao.compip installYespypi.orgQuickstarter browsingYesapi.github.com

### Quick Setup

Each competition needs its own virtual environment (dependencies can conflict).

mkdir -p ~/.crunch/workspace/competitions/<competition>
cd ~/.crunch/workspace/competitions/<competition>
python -m venv .venv && source .venv/bin/activate 
pip install crunch-cli jupyter ipykernel --upgrade --quiet --progress-bar=off
python -m ipykernel install --user --name <competition> --display-name "Crunch - <competition>"

# Get token from: https://hub.crunchdao.com/competitions/<competition>/submit
crunch setup <competition> <project-name> --token <TOKEN>
cd <competition>-<project-name>

For competition-specific packages and full examples, see references/competition-setup.md.

### 1. Discover

crunch list                    # List competitions

### 2. Explain

Read the quickstarter code (main.py or notebook) and competition's SKILL.md/README.md. Provide walkthrough covering: Goal, Interface, Data flow, Approach, Scoring, Constraints, Limitations, Improvement ideas.

### 3. Propose Improvements

Analyze current approach, cross-reference competition docs (SKILL.md, LITERATURE.md, PACKAGES.md), generate concrete code suggestions:

Model: mixture densities, NGBoost, quantile regression, ensembles
Features: volatility regimes, cross-asset correlation, seasonality
Architecture: online learning, Bayesian updating, horizon-specific models

### 4. Test

crunch test                    # Test solution locally

### 5. Submit

crunch test                    # Always test first
crunch push -m "Description"   # Submit

### Phrase Mapping

User saysActionwhat competitions are availablecrunch listshow quickstarters for <name>Fetch from GitHub APIset up <competition>Full workspace setupdownload the datacrunch downloadget the <name> quickstartercrunch quickstarter --nameexplain this quickstarterStructured code walkthroughpropose improvementsAnalyze and suggest code improvementstest my solutioncrunch testcompare with baselineRun both, side-by-side resultssubmit my solutioncrunch push

### Important Rules

Entrypoint must be main.py (default for crunch push/crunch test)
Model files go in resources/ directory
Respect competition interface and constraints (time limits, output format)
Ask before installing new packages

### Reference

CLI commands: references/cli-reference.md
Setup examples: references/competition-setup.md
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: philippWassibauer
- Version: 0.1.2
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/crunch-compete)
- [Send to Agent page](https://openagent3.xyz/skills/crunch-compete/agent)
- [JSON manifest](https://openagent3.xyz/skills/crunch-compete/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/crunch-compete/agent.md)
- [Download page](https://openagent3.xyz/downloads/crunch-compete)