workflow-design

workflow-design is a skill for Claude Code, Codex from mrpulor-gh/nuphus. It costs 0 tokens per session (6,003 once invoked), scanned A, original, Apache-2.0.

A method for designing and testing multi-step computer workflows, including their inputs, actions, conditions, and error handling.

In plain words
What is it for?
Use it to inspect screens, save confirmed layouts, create workflow and parameter files, validate workflows, run them, and record lessons from failures.
Why use it?
It reduces repeated screen exploration and makes each workflow step traceable to confirmed interface evidence. Validation and repeated runs help expose inconsistent results and unusual cases.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to inspect screens, save confirmed layouts, create workflow and parameter files, validate workflows, run them, and record lessons from failures.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/mrpulor-gh/nuphus/workflow-design
Install

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.

Any agent
npx skills add mrpulor-gh/nuphus --skill workflow-design
Clone the repo
git clone --depth 1 https://github.com/mrpulor-gh/nuphus

Made for: Claude Code, Codex.

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

agentmods badge for workflow-design

README.md
[![agentmods](https://agentmods.dev/badge/skills/mrpulor-gh/nuphus/workflow-design/github.svg)](https://agentmods.dev/skills/mrpulor-gh/nuphus/workflow-design)
Your own site
<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.

agentmods 80×15 button for workflow-design

Your own site · 80×15
<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>
Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 6,003 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

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.

ModelPer sessionOnce 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

Measured today against content hash 79847ae878b9, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

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.

plugin/skills/builtin/workflow-design/SKILL.md · 362 lines

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} 跳过当前迭代

Read the full file on GitHub · 362 lines

Files

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.

Changes

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.

  1. today Changed · +21 lines 79847ae878b9
  2. 10d ago Changed · -14 lines ad96573893e0
  3. 11d ago Changed · +1 lines 5698ccde092d
  4. 1mo ago Changed · +13 lines ac37730adc70
  5. 1mo ago Changed · -1 lines 85655ac4df85
  6. 1mo ago Changed · +4 lines 9e19b0d53d8a
  7. 1mo ago Changed · +5 lines 67ffb60b286f
  8. 1mo ago Changed · +74 lines fd565dbdc8f3
  9. 1mo ago Changed · +4 lines f2a1c3614a5c
  10. 1mo ago First seen · 255 lines · 0 tokens per session scan A 9f4a96d5b0a2

Subscribe to this mod's changes

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.

Related

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.

Ascend/agent-skills · 69 tokens

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…

manushi4/Screenhand · 79 tokens

trulens-evaluation-workflow

Systematically evaluate your LLM application with TruLens.

truera/trulens · 18 tokens

playwright-cli

A command-line tool for controlling Chromium, Firefox, and WebKit browsers, including navigation, page interaction, screenshots, PDFs, and recorded actions.

UnicomAI/wanwu · 76 tokens

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…

fengshao1227/ccg-workflow · 97 tokens

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.

milind-soni/OpenMausBot · 39 tokens