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#

SituationActionNeed one file with README + use cases + protocol + ClawHubLoad public/llm-full.txt or /llm-full.txt (running app).402 / MPP / wallet confusion**CLAWHUB.md** + relevant route in server/index.js.UI works but API 404 / HTMLBackend not running or stale process — restart npm run server ( 8787).Verify live MPP handler exists**GET http://localhost:8787/api/dance-extras/live** → JSON with flowKeys.Which screens exist**src/hubRoutes.ts; hub /.Changed markdown included in bundlenpm run build:llm** (runs before npm run build).EVVM (deploy, CLI, Tempo testnet)docs/EVVM_TEMPO.md, /evvm; deep: https://www.evvm.info/llms-full.txt.MPPScan / OpenAPI**GET /openapi.json**; npm run discovery · **docs/MPPSCAN_DISCOVERY.md**Promotion of a fix for future agentsShort entry under Successes or Failures in CLAWHUB.md (no secrets).

---

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):

bash

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

Manual copy to OpenClaw skills dir (optional):

bash

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)#

text

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#

ArtifactRole**public/llm-full.txt** (singular)DanceTempo-generated; committed; use first.https://www.evvm.info/llms-full.txt (plural)Upstream EVVM protocol dump — attach for EVVM-only depth; do not duplicate into public/ unless you intend to maintain a fork.

---

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#

TopicLocationLive MPP dance flows**POST /api/dance-extras/live/:flowKey/:network** — GET /api/dance-extras/liveHub routessrc/hubRoutes.tsBrowser MPPsrc/danceExtrasLiveMpp.ts, src/danceExtrasJudgeWire.tsServerserver/index.js

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#

ContentWhereStable facts (routes, env names, ports)README.md, DANCETECH_USE_CASES.md, or relevant docs/*.md — then npm run build:llm.Incident / debugging narrative**CLAWHUB.md** Successes / Failures.EVVM upstream protocolLink https://www.evvm.info/llms-full.txt; keep docs/EVVM_TEMPO.md for Tempo-specific steps.

---

Verification script#

From repo root (optional):

bash

./.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.

bash

# 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#

PathPurposeSKILL.mdThis file — primary skill entryREADME.mdPackage manifest + upload notes for ClawHubreferences/copilot-and-agents.mdPaste blocks for Copilot / chatreferences/openclaw-dancetempo.mdOpenClaw workspace alignmentreferences/examples.mdConcrete @-mentions, curls, patternsreferences/troubleshooting.mdCommon failures & fixesassets/LLM-BUNDLE-SOURCES.mdWhat feeds llm-full.txt``assets/SKILL-TEMPLATE.mdTemplate for forking this skillscripts/verify-dancetempo-context.shQuick repo checkshooks/openclaw/HOOK.mdOpenClaw hook manifesthooks/openclaw/handler.jsBootstrap injector (CommonJS)hooks/openclaw/handler.tsBootstrap injector (TypeScript)hooks/README.mdHook folder index

---

See also#

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