converge-design
Use this skill to design and prototype interfaces for Converge — the framework for long-running AI agents that adapt until outcomes converge. Optimised for playbook surfaces (task tree, run journal, human-review flow) but works for any Converge-flavored artifact. Contains the canonical brand contract (tokens, voice, banned words), the editorial typography rules, and a working React UI kit for the playbook + review workspace.
- License 许可
- MIT
- 最近更新
- 2026-06-13
- Stars
- ★ 3
- Forks
- 1
01 前言 Front Matter
- name
- converge-design
- description
- Use this skill to design and prototype interfaces for Converge — the framework for long-running AI agents that adapt until outcomes converge. Optimised for playbook surfaces (task tree, run journal, human-review flow) but works for any Converge-flavored artifact. Contains the canonical brand contract (tokens, voice, banned words), the editorial typography rules, and a working React UI kit for the playbook + review workspace.
- user-invocable
- true
02 资源文件 45
- 其他.thumbnail5.0 KB
- 资产文件assets/converge-apple-touch-icon.png5.8 KB
- 资产文件assets/converge-banner.svg4.3 KB
- 资产文件assets/converge-favicon.svg1.3 KB
- 资产文件assets/converge-logo.svg2.7 KB
- 其他colors_and_type.css19.9 KB
- 参考文档preview/01-color-body.html2.2 KB
- 参考文档preview/02-color-status.html2.0 KB
- 参考文档preview/03-color-accent.html2.2 KB
- 参考文档preview/04-color-review.html2.0 KB
- 参考文档preview/05-color-diagram.html2.4 KB
- 参考文档preview/06-type-display.html731 B
- 参考文档preview/07-type-headings.html1.1 KB
- 参考文档preview/08-type-italic-emphasis.html1.0 KB
- 参考文档preview/09-type-mono.html1.1 KB
- 参考文档preview/10-spacing-scale.html2.4 KB
- 参考文档preview/11-radii.html1.2 KB
- 参考文档preview/12-borders.html1.2 KB
- 参考文档preview/13-shadow-pop.html1.6 KB
- 参考文档preview/14-button-primary.html1008 B
- 参考文档preview/15-button-review.html944 B
- 参考文档preview/16-status-indicators.html1.8 KB
- 参考文档preview/17-pill-tags.html1.1 KB
- 参考文档preview/18-task-row.html10.7 KB
- 参考文档preview/19-review-verdict-card.html1.7 KB
- 参考文档preview/20-link-styles.html1.0 KB
- 参考文档preview/21-brand-mark.html3.0 KB
- 参考文档README.md21.0 KB
- 其他reference/converge-animations.css485 B
- 参考文档reference/converge-brand.json1.6 KB
- 其他reference/converge-diagrams.css16.5 KB
- 其他reference/converge-globals.css1.3 KB
- 其他reference/converge-tokens.css3.6 KB
- 其他reference/converge-typography.css1.7 KB
- 其他ui_kits/playbook/App.jsx8.2 KB
- 其他ui_kits/playbook/chat.jsx6.6 KB
- 脚本ui_kits/playbook/data.js10.8 KB
- 参考文档ui_kits/playbook/index.html2.5 KB
- 其他ui_kits/playbook/primitives.jsx4.4 KB
- 参考文档ui_kits/playbook/README.md4.3 KB
- 其他ui_kits/playbook/workspace.jsx32.2 KB
- 资产文件uploads/pasted-1779860792144-0.png187.4 KB
- 资产文件uploads/pasted-1779860988870-0.png623.9 KB
- 资产文件uploads/pasted-1779861060159-0.png623.9 KB
- 资产文件uploads/pasted-1779864023566-0.png27.5 KB
03 SKILL.md 正文
Converge — Design Skill
Read README.md first — it is the system reference. Then open colors_and_type.css for the tokens, reference/converge-brand.json for the voice contract, and ui_kits/playbook/ for a working three-pane workspace recreation.
Working artifacts
- Static HTML / SVG / illustration → reference the tokens with
<link rel="stylesheet" href="path/to/colors_and_type.css">. Compose with the.cv-*semantic classes (.cv-h2,.cv-body,.cv-eyebrow,.cv-pill,.cv-status,.cv-card,.cv-link-arrow). Stay inside the brand contract — terracotta only for italic-emphasis, link hover, and.cv-highlight; status palette only on glyph-as-type captions. - React prototype → copy from
ui_kits/playbook/and adapt.primitives.jsxis the atoms layer. Keep style objects scoped to each file (the kit uses inline styles for collision safety). - Production code → mirror
reference/converge-tokens.cssinto the project. The upstream landing page uses Tailwind v4 with@themetokens — seereference/converge-tokens.cssfor the@themeblock.
Brand contract — non-negotiable
- Tagline: "Define done. Converge gets there."
- Mental model: diverge → converge.
- Voice tones: direct · technical · honest about trade-offs.
- Banned words:
revolutionary·next-generation·AI-native·game-changing. Treat as compile errors. Synonyms (paradigm shift,cutting-edge,industry-leading) are also banned. - Preferred words:
concrete·shipped·measurable·verifiable. - Italic emphasis is the brand motif — wrap the one noun the sentence is about in
<em>and let it render Crimson Pro Italic 500 terracotta.
Scope rules — non-negotiable
--cv-status-*→ data-viz only. Glyph-as-type captions and status spans. Never on body text, links, CTAs, or headings.--cv-diagram-*+ indigo + violet + cyan + rose → inside.cv-diagramSVG subtree only. Never on app chrome.--cv-accent-warm(terracotta) → italic-emphasis spans + link:hover+.cv-highlightonly. Never a CTA fill. Never a heading color. Never a border on something that isn't a marker.- Everything else (bg, text, border) → use anywhere.
When invoked with no guidance
Ask what the user wants to design. Likely candidates:
- A new screen inside the playbook workspace (the run journal full view, the playbook catalog, the new-playbook composer)
- A status / progress mock for a particular playbook run
- A README diagram for a new RFC
- A marketing tile for a new example playbook
- A doc page in the Converge docs (
/docs/getting-started/...)
Once the surface is clear, ask:
- Static HTML or interactive React?
- Light cream chrome only, or include a dark code/journal panel?
- One direction, or 2–3 variations to compare?
Then build. Always copy the relevant atoms out of ui_kits/playbook/primitives.jsx instead of re-inventing them, and always pull tokens from colors_and_type.css instead of hardcoding hex values.
Banned-word lint
Before shipping any copy, search the output for the banned words above. If you find one, rewrite the sentence using the preferred words and one of the brand-voice patterns:
- "Long-running AI agents that adapt until outcomes converge."
- "Each task declares its outputs and the shell checks that prove them."
- "A playbook can burn tens of millions of tokens; the price gap matters."
- "That's the loop that adapts when reality breaks the plan."
If unsure whether a word is banned, ask the user — better one round of clarification than shipping copy that violates the contract.
04 同仓库更多 Skills
hello-checker
Use this skill when asked to "verify", "check", or "validate" a file's existence and content. It provides a reliable workflow for confirming files meet their spec.
ask-skill
暂无简介
html-review-artifact
Framework-wide guidance for crafting polished human-review artifacts as markdown or HTML
converge-planning
Design a Converge playbook end-to-end. Use when the user says "plan a project", "design a playbook", "decompose into tasks", "scaffold a Converge workflow", "onboard to Converge", or asks how to write TASK.md / playbook.yml. Two entry points: plan a new playbook or update an existing one. Hand off to `/converge-control` after producing the playbook structure.
converge-control
Operate a Converge playbook end-to-end — start runs, monitor progress, narrow failures with `--select`, inspect runtime state, validate definitions, surgically reset subtrees, and stop stuck or orphaned runs. Use this skill whenever the user says "run my playbook", "execute this", "monitor the run", "converge failed", "the run is stuck", "retry failures", "babysit this playbook", "what's the status?", "show me the gantt", or asks how to use `converge run` / `--select` / `inspect` / `doctor` / `clean` / `stop`. Also use it for `HTTP 401` / `Invalid API key` failures on the first task — those are environment-not-playbook problems — and for any post-run cleanup work. Hand off to `converge-planning` if the user wants to design or restructure the playbook itself.
repair-taskts
Fix task.ts definition issues — Seed syntax, missing .build(), empty checks, import errors, TypeScript errors