Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add mrpulor-gh/nuphus --skill workflow-designgit clone --depth 1 https://github.com/mrpulor-gh/nuphusWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/mrpulor-gh/nuphus/workflow-design)<a href="https://agentmods.dev/skills/mrpulor-gh/nuphus/workflow-design"><img src="https://agentmods.dev/badge/skills/mrpulor-gh/nuphus/workflow-design/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/mrpulor-gh/nuphus/workflow-design"><img src="https://agentmods.dev/badge/skills/mrpulor-gh/nuphus/workflow-design.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00000 | $0.06003 |
| Opus 5.5 | $0.00000 | $0.02401 |
| Sonnet 5.5 | $0.00000 | $0.01201 |
| Haiku 4.5 | $0.00000 | $0.00600 |
Grade A, and why
workflow-design scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 362 lines — stays where its author put it; the contents beside it link to each section on GitHub.
工作流设计经验手册
完整工作流编排能力:步骤 schema、变量语法、条件表达式、params 固化、外部输入声明、设计模式、验证闭环、经验闭环。 分工:执行沟通纪律与输入骨架判定在系统提示词 L2;界面交互细则在 skill: workflow-interaction;本文只管编排设计与验证闭环。
〇、编排闭环总览
接收任务
├─ [查] ui_maps_search 检索同类经验 → 有 screen/experience 直接复用,跳过重复探索
├─ [探] UIA/Accessibility 优先跑通核心路径;只在工作流依赖时补视觉或旁支证据
├─ [固] 生成 params.json + workflow.json + guide.md(核心路径参数都有界面证据)
├─ [验] workflow_validate 编译校验 → workflow_run 真实成功一次;失败时针对性修正重跑
└─ [馈] 跑通后 ui_maps_save_experience 提炼经验;新异常回写 params.json exceptions;跨会话进展用 workflow_memory_update 写增量摘要
输入形态(意图骨架 vs 自由对话)的判定与处理在系统提示词 L2「输入即骨架」;表单行意图是纯文本、无工具参数,稳定的语义定位器、窗口身份和视觉锚点规则由你探索后固化进 params.json / with,不保存本次捕获 ID 或绝对坐标常量。
一、步骤 Schema(V2,唯一真相源 src/workflow/step_schema.json)
顶层字段(workflow.json)
| 字段 | 说明 |
|---|---|
id / name |
工作流标识 / 显示名 |
status |
设计保存写 Draft;Ready / Running / Completed / Error 由运行引擎维护,不手改 |
steps |
步骤数组(见下方步骤字段) |
doc |
计划 markdown;不参与模板变量扫描(正文写 {{inputs.x}} 不算引用) |
schedule |
定时调度配置(schedule_cron 管理),无则 null |
run_history |
运行历史;同 id 重跑前若怀疑变量陈旧,置 [](断点续连会复用上次成功步骤的 capture 值) |
dry_run |
true = 只编译不执行(与 workflow_validate 是两回事) |
目录噪声(不参与执行):
workflow.<时间戳>.json(写盘备份)、导出件、canvas.layout.json、screenshots/——引擎只读各目录的workflow.json。
公共字段
| 字段 | 必填 | 说明 |
|---|---|---|
id |
✅ | 步骤唯一标识(断点续连按 id 跳过已完成步骤) |
name |
✅ | 人类可读名称 |
description |
可选 | 详细说明 |
on_error |
可选 | "abort"(默认) / "skip" / {retry:{max,backoff_ms?,backoff_multiplier?}} / {allow_codes:{codes:[...]}} |
capture |
可选 | 字符串:步骤输出存入变量名(无对象格式) |
timeout_secs |
可选 | 步骤超时秒数 |
do |
✅ | 动作定义,仅下列一种 key |
动作类型(do 的 13 种形态)
| kind | 写法 | 要点 |
|---|---|---|
| tool | {"tool":"desktop_mouse","with":{...}} |
with 支持 {{var}} 模板 |
| seq | {"seq":[...]} |
顺序容器,可嵌套 |
| loop | {"loop":{"for_each"|"repeat"|"until":..., "max":100, "do":[...]}} |
until=条件满足即停;max 防死循环 |
| if | {"if":{"condition":{...},"then":[...],"else":[...]}} |
else 可省略 |
| call | {"call":"wf-id","with":{"inputs":{...},"outputs":{...}}} |
inputs 传子变量;outputs 子变量名→父变量名回写 |
| wait | {"wait":"提示语","auto":[...]} |
auto=等待期自动执行步骤(可选) |
| chat | {"chat":"LLM任务描述","with":{...}} |
LLM 决策节点(原 chat_agent) |
| script | {"script":{"runtime":"python"|"node"|"ahk"|"pwsh","code":"...","cwd":"?"}} |
code 支持 {{var}} 替换 |
| assert | {"assert":{"condition":{...},"message":"?"}} |
on_error=skip 时变非阻断校验 |
| mcp | {"mcp":{"server":"key","tool":"name","with":{...}}} |
server 对应 servers.yaml |
| sleep | {"sleep":N} |
秒,0.1–3600 |
| break | {"break":true} |
跳出当前循环 |
| continue | {"continue":true} |
跳过当前迭代 |
What ships with it
1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- today Changed · +21 lines 79847ae878b9
- 10d ago Changed · -14 lines ad96573893e0
- 11d ago Changed · +1 lines 5698ccde092d
- 1mo ago Changed · +13 lines ac37730adc70
- 1mo ago Changed · -1 lines 85655ac4df85
- 1mo ago Changed · +4 lines 9e19b0d53d8a
- 1mo ago Changed · +5 lines 67ffb60b286f
- 1mo ago Changed · +74 lines fd565dbdc8f3
- 1mo ago Changed · +4 lines f2a1c3614a5c
- 1mo ago First seen · 255 lines · 0 tokens per session scan A 9f4a96d5b0a2
workflow-design is a skill published in the GitHub repository mrpulor-gh/nuphus (89 stars, last pushed today), licensed Apache-2.0. It costs nothing until one of its globs matches a file; then it loads 6,003 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
atb-ops-to-aclnn-migration-workflow
A standard workflow for migrating ATB OPS implementations to ACLNN. It combines preparation, design documentation, CSV test-case planning, implementation, compilation, and testing into staged checkpoints.
qa-smoke-test
Run automated QA tests on desktop apps or websites. Smoke tests, visual regression, UI validation, accessibility checks, end-to-end flows. Use when: "test this app", "smoke test", "check if login works", "validate the UI", "visual regression", "verify button is clickable", "test flow", "QA check", "accessibility…
trulens-evaluation-workflow
Systematically evaluate your LLM application with TruLens.
playwright-cli
A command-line tool for controlling Chromium, Firefox, and WebKit browsers, including navigation, page interaction, screenshots, PDFs, and recorded actions.
ccg-workflow
How to run a non-trivial change end to end with the CCG role tools (ccganalyze / ccgdesign / ccgbuild / ccgdebug / ccgoptimize / ccgreview / ccgtest) and the verify- quality gates. Use when a task is a whole feature, a refactor, a bug whose cause is not yet known, or any change large enough that one straight-through…
create-verification-skill
Create one skill that teaches a bot how to launch, drive, and verify a specific app or project. Use only when the user explicitly asks for a verification skill.