DanceTempo · ClawHub context skill

---

name: clawhub

description: >-

DanceTempo / DanceTech Protocol — full repo context via public/llm-full.txt (or /llm-full.txt),

tribal debugging via CLAWHUB.md, Tempo + MPP/x402 patterns, dance-extras live routes, EVVM on

Tempo testnet. Use when: (1) Onboarding an agent or pasting system context, (2) Debugging 402/MPP,

stale API, or port 8787 issues, (3) Editing docs that feed llm-full.txt, (4) Working on hub routes,

server/index.js, or integrations (AgentMail, purl, OpenAI MPP, etc.), (5) EVVM deploy/docs,

(6) Preparing a ClawHub or Copilot instruction bundle, (7) MPPScan/OpenAPI discovery at

GET /openapi.json. For raw EVVM protocol depth, fetch

https://www.evvm.info/llms-full.txt (not vendored in-repo).

metadata: {}

---

# 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

| Situation | Action |

| --- | --- |

| Need **one file** with README + use cases + protocol + ClawHub | Load **`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 / HTML** | Backend 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 bundle | **`npm 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 agents | Short 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):**

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

| Artifact | Role |

| --- | --- |

| **`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:

Deeper: **`references/troubleshooting.md`**.

---

Key implementation pointers

| Topic | Location |

| --- | --- |

| Live MPP dance flows | **`POST /api/dance-extras/live/:flowKey/:network`** — **`GET /api/dance-extras/live`** |

| Hub routes | **`src/hubRoutes.ts`** |

| Browser MPP | **`src/danceExtrasLiveMpp.ts`**, **`src/danceExtrasJudgeWire.ts`** |

| Server | **`server/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:**

---

Promotion: CLAWHUB vs llm-full

| Content | Where |

| --- | --- |

| **Stable 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 protocol** | Link **`https://www.evvm.info/llms-full.txt`**; keep **`docs/EVVM_TEMPO.md`** for Tempo-specific steps. |

---

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](https://clawhub.ai/pskoett/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

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

| Path | Purpose |

| --- | --- |

| `SKILL.md` | This file — primary skill entry |

| `README.md` | Package manifest + upload notes for ClawHub |

| `references/copilot-and-agents.md` | Paste blocks for Copilot / chat |

| `references/openclaw-dancetempo.md` | OpenClaw workspace alignment |

| `references/examples.md` | Concrete @-mentions, curls, patterns |

| `references/troubleshooting.md` | Common failures & fixes |

| `assets/LLM-BUNDLE-SOURCES.md` | What feeds `llm-full.txt` |

| `assets/SKILL-TEMPLATE.md` | Template for forking this skill |

| `scripts/verify-dancetempo-context.sh` | Quick repo checks |

| `hooks/openclaw/HOOK.md` | OpenClaw hook manifest |

| `hooks/openclaw/handler.js` | Bootstrap injector (CommonJS) |

| `hooks/openclaw/handler.ts` | Bootstrap injector (TypeScript) |

| `hooks/README.md` | Hook folder index |

---

See also