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. - The task touches
server/index.js, server/payments.js, or src/danceExtras*.ts. - Docs are edited that appear in
scripts/build-llm-full.mjs (bundle sources). - 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. - 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):
CODEBLOCK0
Manual copy to OpenClaw skills dir (optional):
CODEBLOCK1
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)
CODEBLOCK2
First load (full orientation)
- 1. Prefer
public/llm-full.txt (or /llm-full.txt from a running build) — includes CLAWHUB.md in the bundle. - 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:
- - 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
| 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). - 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
| 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):
CODEBLOCK3
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.
CODEBLOCK4
- -
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. - After editing any file listed in
build-llm-full.mjs, run npm run build:llm before claiming “docs are updated in the bundle.” - Prefer
GET /api/dance-extras/live over guessing whether the server is new. - For EVVM, answer no to optional Sepolia registry registration until policy allows (see
docs/EVVM_TEMPO.md).
Files in this package
| Path | Purpose |
|---|
| INLINECODE92 | This file — primary skill entry |
| INLINECODE93 |
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
- - Upstream inspiration: self-improving-agent (structure: references, assets, scripts, hooks).
- DanceTempo repo:
README.md, CLAWHUB.md.
DanceTempo · ClawHub 上下文技能
DanceTempo 是参考性的 DanceTech 协议 超级应用:React 中心 + 专用路由,Node/Express API,Tempo 结算,MPP / x402 机器支付。此技能告知代理 上下文所在位置 以及 如何避免已知陷阱(参见 CLAWHUB.md)。
快速参考
| 情况 | 操作 |
|---|
| 需要 一个文件 包含 README + 用例 + 协议 + ClawHub | 加载 public/llm-full.txt 或 /llm-full.txt(运行中的应用)。 |
| 402 / MPP / 钱包 混淆 |
CLAWHUB.md +
server/index.js 中的相关路由。 |
|
UI 正常但 API 返回 404 / HTML | 后端未运行或进程
过期 — 重启
npm run server(
8787)。 |
| 验证实时 MPP 处理器是否存在 |
GET http://localhost:8787/api/dance-extras/live → 返回包含 flowKeys 的 JSON。 |
|
存在哪些屏幕 |
src/hubRoutes.ts;中心路由
/。 |
|
修改后的 markdown 包含在构建包中 |
npm run build:llm(在
npm run build 之前运行)。 |
|
EVVM(部署、CLI、Tempo 测试网) |
docs/EVVM_TEMPO.md,
/evvm;深入:
https://www.evvm.info/llms-full.txt。 |
|
MPPScan / OpenAPI |
GET /openapi.json;
npm run discovery ·
docs/MPPSCAN_DISCOVERY.md |
|
推广 修复供未来代理使用 | 在
CLAWHUB.md 的
成功 或
失败 下简短记录(无机密信息)。 |
何时激活(触发条件)
当以下情况时自动使用此技能:
- 1. 用户 @-提及 llm-full.txt、CLAWHUB、DanceTempo、MPP、dance-extras 或 Tempo 测试网/主网。
- 任务涉及 server/index.js、server/payments.js 或 src/danceExtras*.ts。
- 编辑出现在 scripts/build-llm-full.mjs(构建包源)中的文档。
- 用户上传 ClawHub / OpenClaw / Copilot 上下文问题。
推荐:Cursor / IDE
- 1. @ public/llm-full.txt 用于广泛变更;@ CLAWHUB.md 用于调试过往事件。
- 项目规则:仓库根目录 AGENTS.md 或 .cursor/rules(如果存在)— 与 README.md 保持一致。
参见 references/openclaw-dancetempo.md 获取 OpenClaw 工作区文件提示。
安装
从此仓库(权威来源):
bash
技能位于:
.cursor/skills/clawhub/
手动复制到 OpenClaw 技能目录(可选):
bash
cp -r .cursor/skills/clawhub ~/.openclaw/skills/dancetempo-clawhub
ClawHub(发布): 压缩 clawhub/(此文件夹),使列表包含 SKILL.md、references/、assets/、hooks/、scripts/。参见此文件夹中的 README.md 获取文件清单。
仓库地图(查看位置)
dancetempo/
├── public/llm-full.txt # 生成文件 — 请勿手动编辑;运行 npm run build:llm
├── CLAWHUB.md # 集体知识:成功、失败、检查清单
├── README.md # 路由、技术栈、快速入门
├── DANCETECHUSECASES.md # 逐流程 API 合约
├── server/index.js # Express 路由、集成、MPP 代理
├── server/openapi.mjs # 用于 GET /openapi.json 的 OpenAPI 3.1(MPPScan)
├── server/payments.js # 链 ID、收费辅助函数
├── src/hubRoutes.ts # 所有 /routes 的中心目录
├── src/danceExtrasLiveMpp.ts # 浏览器 MPP 辅助函数(实时流程)
├── src/danceExtrasJudgeWire.ts # 裁判评分线片段
├── .github/copilot-instructions.md
└── scripts/build-llm-full.mjs # llm-full.txt 的源列表
首次加载(全面定位)
- 1. 优先使用 public/llm-full.txt(或运行构建中的 /llm-full.txt)— 包含 CLAWHUB.md 在构建包中。
- 文档编辑后重新生成:npm run build:llm。
构建包源
精确列表:assets/LLM-BUNDLE-SOURCES.md(镜像 build-llm-full.mjs)。
EVVM:llm-full.txt 与 llms-full.txt
| 产物 | 作用 |
|---|
| public/llm-full.txt(单数) | DanceTempo 生成;已提交;优先使用。 |
| https://www.evvm.info/llms-full.txt(复数) |
上游 EVVM 协议转储 —
仅用于 EVVM 深度分析时附加;除非你打算维护一个分支,否则不要复制到 public/ 中。 |
调试(集体知识)
阅读 CLAWHUB.md 了解:
- - 成功/失败的内容(purl、AgentMail、402 循环、8787 端口上过期的 Express 等)
- 可重复的检查(例如 GET /api/dance-extras/live)
更深入:references/troubleshooting.md。
关键实现要点
| 主题 | 位置 |
|---|
| 实时 MPP 舞蹈流程 | POST /api/dance-extras/live/:flowKey/:network — GET /api/dance-extras/live |
| 中心路由 |
src/hubRoutes.ts |
| 浏览器 MPP |
src/danceExtrasLiveMpp.ts,
src/danceExtrasJudgeWire.ts |
| 服务器 |
server/index.js |
具体片段:references/examples.md。
Copilot Chat 集成
GitHub Copilot 不会自动加载此文件夹。选项:
- 1. 提交 /.github/copilot-instructions.md(已在 DanceTempo 仓库中)。
- 从 references/copilot-and-agents.md 粘贴到聊天或组织指令中。
快速提示:
- - “将此 PR 的上下文使用 llm-full.txt。”
- “在修改服务器之前,扫描 CLAWHUB.md 了解 8787 / MPP / purl。”
- “此任务完成后,建议一条 CLAWHUB 成功或失败记录(无机密信息)。”
- “重新生成 public/llm-full.txt — 哪些文件是输入?” → assets/LLM-BUNDLE-SOURCES.md
推广:CLAWHUB 与 llm-full
| 内容 | 位置 |
|---|
| 稳定事实(路由、环境名称、端口) | README.md,DANCETECHUSECASES.md,或相关 docs/*.md — 然后 npm run build:llm。 |
| 事件/调试叙述 |
CLAWHUB.md 成功/失败。 |
|
EVVM 上游协议 | 链接
https://www.evvm.info/llms-full.txt;将
docs/EVVM_TEMPO.md 用于 Tempo 特定步骤。 |
验证脚本
从仓库根目录(可选):
bash
./.cursor/skills/clawhub/scripts/verify-dancetempo-context.sh
检查