DanceTempo · ClawHub context skill

DanceTempo is the reference DanceTech Protocol superapp: React hub + dedicated routes, Node/Express API, Tempo settlement, MPP / x402 machine payments. This skill tells agents where context lives and how to avoid known traps (see CLAWHUB.md).

Quick reference

When to activate (triggers)

Use this skill automatically when:

1. The user @-mentions llm-full.txt, CLAWHUB, DanceTempo, MPP, dance-extras, or Tempo testnet/mainnet.
2. The task touches server/index.js, server/payments.js, or src/danceExtras*.ts.
3. Docs are edited that appear in scripts/build-llm-full.mjs (bundle sources).
4. The user uploads ClawHub / OpenClaw / Copilot context questions.

Recommended: Cursor / IDE

1. @ public/llm-full.txt for broad changes; @ CLAWHUB.md when debugging past incidents.
2. Project rules: repo root AGENTS.md or .cursor/rules if present — align with README.md.

See references/openclaw-dancetempo.md for OpenClaw workspace file hints.

Installation

From this repository (authoritative):

# Skill lives at:
.cursor/skills/clawhub/

Manual copy to OpenClaw skills dir (optional):

cp -r .cursor/skills/clawhub ~/.openclaw/skills/dancetempo-clawhub

ClawHub (publish): Zip clawhub/ (this folder) so the listing includes SKILL.md, references/, assets/, hooks/, scripts/. See README.md in this folder for a file manifest.

Repository map (where to look)

dancetempo/
├── public/llm-full.txt          # Generated — do not hand-edit; run npm run build:llm
├── CLAWHUB.md                   # Tribal knowledge: successes, failures, checklists
├── README.md                    # Routes, stack, quick start
├── DANCETECH_USE_CASES.md       # Flow-by-flow API contract
├── server/index.js              # Express routes, integrations, MPP proxies
├── server/openapi.mjs           # OpenAPI 3.1 for GET /openapi.json (MPPScan)
├── server/payments.js           # Chain IDs, charge helpers
├── src/hubRoutes.ts             # Hub directory of all /routes
├── src/danceExtrasLiveMpp.ts    # Browser MPP helpers (live flows)
├── src/danceExtrasJudgeWire.ts  # Judge-score wire snippets
├── .github/copilot-instructions.md
└── scripts/build-llm-full.mjs   # Source list for llm-full.txt

First load (full orientation)

1. Prefer public/llm-full.txt (or /llm-full.txt from a running build) — includes CLAWHUB.md in the bundle.
2. Regenerate after doc edits: npm run build:llm.

Bundle sources

Exact list: assets/LLM-BUNDLE-SOURCES.md (mirrors build-llm-full.mjs).

EVVM: llm-full.txt vs llms-full.txt

Debugging (tribal knowledge)

Read CLAWHUB.md for:

• What succeeded / failed (purl, AgentMail, 402 loops, stale Express on 8787, etc.)
• Repeatable checks (e.g. GET /api/dance-extras/live)

Deeper: references/troubleshooting.md.

Key implementation pointers

Concrete snippets: references/examples.md.

Copilot Chat integration

GitHub Copilot does not load this folder automatically. Options:

1. Commit /.github/copilot-instructions.md (already in DanceTempo repo).
2. Paste from references/copilot-and-agents.md into chat or org instructions.

Quick prompts:

• “Use llm-full.txt as context for this PR.”
• “Scan CLAWHUB.md for 8787 / MPP / purl before changing the server.”
• “After this task, suggest one CLAWHUB Success or Failure line (no secrets).”
• “Regenerate public/llm-full.txt — which files are inputs?” → assets/LLM-BUNDLE-SOURCES.md

Promotion: CLAWHUB vs llm-full

Verification script

From repo root (optional):

./.cursor/skills/clawhub/scripts/verify-dancetempo-context.sh

Checks that public/llm-full.txt exists and reminds you of the live MPP GET check.

OpenClaw hook (optional)

Parity with self-improving-agent: injects a virtual DANCETEMPO_CONTEXT_REMINDER.md on agent:bootstrap (skips sub-agents). No network I/O.

# From this skill folder (or repo: .cursor/skills/clawhub/)
cp -r hooks/openclaw ~/.openclaw/hooks/dancetempo-clawhub

openclaw hooks enable dancetempo-clawhub

• hooks/openclaw/HOOK.md — metadata + enable/disable.
• hooks/openclaw/handler.js — CommonJS handler (primary).
• hooks/openclaw/handler.ts — TypeScript handler for OpenClaw (types from openclaw/hooks at runtime).

Full notes: references/openclaw-dancetempo.md.

Best practices

1. Never paste real .env secrets into prompts — use .env.example names only.
2. After editing any file listed in build-llm-full.mjs, run npm run build:llm before claiming “docs are updated in the bundle.”
3. Prefer GET /api/dance-extras/live over guessing whether the server is new.
4. For EVVM, answer no to optional Sepolia registry registration until policy allows (see docs/EVVM_TEMPO.md).

Files in this package

See also

• Upstream inspiration: self-improving-agent (structure: references, assets, scripts, hooks).
• DanceTempo repo: README.md, CLAWHUB.md.