workflow-to-skill-with-surface

workflow-to-skill-with-surface is a skill for Claude Code, Codex from ailiheizi/workflow-to-skill. It costs 91 tokens per session (2,529 once invoked), scanned C, original, Apache-2.0.

A method for turning a repeatable workflow into a reusable agent skill with an optional dedicated form, button interface, or results view.

In plain words
What is it for?
It helps define the workflow, connect it to an existing system or service, map interface inputs to skill messages, and present the resulting output.
Why use it?
It keeps the workflow's instructions in one place while allowing people to provide structured inputs and see ordinary task results through a tailored interface.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: $skill-name invocation.

Good fit It helps define the workflow, connect it to an existing system or service, map interface inputs to skill messages, and present the resulting output.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/ailiheizi/workflow-to-skill/workflow-to-skill-with-surface
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 ailiheizi/workflow-to-skill --skill workflow-to-skill-with-surface
Clone the repo
git clone --depth 1 https://github.com/ailiheizi/workflow-to-skill

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-to-skill-with-surface

README.md
[![agentmods](https://agentmods.dev/badge/skills/ailiheizi/workflow-to-skill/workflow-to-skill-with-surface/github.svg)](https://agentmods.dev/skills/ailiheizi/workflow-to-skill/workflow-to-skill-with-surface)
Your own site
<a href="https://agentmods.dev/skills/ailiheizi/workflow-to-skill/workflow-to-skill-with-surface"><img src="https://agentmods.dev/badge/skills/ailiheizi/workflow-to-skill/workflow-to-skill-with-surface/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-to-skill-with-surface

Your own site · 80×15
<a href="https://agentmods.dev/skills/ailiheizi/workflow-to-skill/workflow-to-skill-with-surface"><img src="https://agentmods.dev/badge/skills/ailiheizi/workflow-to-skill/workflow-to-skill-with-surface.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 91 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,529 The whole file, excluding the scripts and references it only reads on demand.
Security scan C 1 finding. A grade says what 26 rules found in the file — not that it is safe.
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.00091 $0.02529
Opus 5 $0.00046 $0.01264
Sonnet 5 $0.00018 $0.00506
Haiku 4.5 $0.00009 $0.00253

Measured 12d ago against content hash daed6a970d7a, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade C, and why

workflow-to-skill-with-surface scanned grade C with 1 finding 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 12d ago.

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.

Harvests environment variableshighData exfiltration

Enumerating or grepping the environment for keys collects credentials unrelated to what the mod says it does.

- collect secrets or grant credentials, permissions, or authority;
workflow-to-skill-with-surface/SKILL.md · 272 lines

How it starts

The opening of the file, as written. The whole thing — 272 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Workflow To Skill With Surface

Create one readable workflow Skill and, when supported, a dedicated Prompt Surface around it. The Skill is the single source of workflow method. The Surface only maps structured input to an ordinary Skill message and presents the Harness's ordinary result.

The target Harness loads the Skill, runs the Agent, and invokes existing CLI, MCP, HTTP, API, Dify, n8n, ComfyUI, or other capabilities. Do not create an executor, workflow runtime, Surface runtime, or second state protocol.

Authoring Method

Use one combined authoring and review flow:

  1. Clarify the workflow outcome, scope, inputs, outputs, side effects, completion criteria, target Harness, and representative success and failure cases. Confirm why a dedicated Surface is useful.
  2. Inspect real Harness documentation and capabilities. Confirm exact tool bindings, important parameter and result contracts, credential binding names, external workflow identity or version, lifecycle states, and success evidence. Confirm Skill installation and invocation plus the Harness's ordinary message, continuation, and result presentation APIs.
  3. Present one proposal covering the workflow and Surface together. Label user-confirmed choices, proposed safe defaults, and unresolved material decisions. Include the visible input-to-prompt mapping and Surface boundary.
  4. Ask for one review of the shared material decisions. Ask again only if a material choice remains unresolved or later changes; do not create a second approval round merely because Surface implementation follows Skill authoring.
  5. Write the candidate SKILL.md after material choices are confirmed or covered by an explicit unattended policy. The Skill must remain complete and usable without the Surface.
  6. Structurally validate, install, discover, and explicitly invoke the Skill through the Harness's ordinary path when authorized. Confirm the intended candidate was loaded rather than a stale or conflicting copy. Exercise safe success and material stop or failure cases before treating the Surface as ready.
  7. Implement the Surface only through the target Harness's native UI and ordinary message/result APIs. If those APIs are unavailable, report the adapter gap instead of adding a Workflow-to-Skill runtime.
  8. Validate input mapping, ordinary invocation-path parity, untrusted input, secrets, result projection, failure behavior, and review continuation when offered. Separate observed behavior from untested claims.

Read the full file on GitHub · 272 lines

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. 12d ago First seen · 272 lines · 91 tokens per session scan C daed6a970d7a

Subscribe to this mod's changes

workflow-to-skill-with-surface is a skill published in the GitHub repository ailiheizi/workflow-to-skill (2 stars, last pushed 18d ago), licensed Apache-2.0. It adds 91 tokens to every session and 2,529 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it C with 1 finding (harvests environment variables). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

desktop-subagent-connector

Securely coordinate a remote sandbox with a user-approved local desktop through scoped file, shell, browser, and GUI access. Use for: remote sandbox, user-approved desktop, local desktop bridge, scoped desktop access.

Stijnman/grok-custom-skills · 48 tokens

agent-reach-wrapper

Thin wrapper around Panniantong/Agent-Reach for live web, YouTube transcripts, RSS, GitHub, Bilibili, Exa search, and optional login-state platforms (X, Reddit, Facebook, Instagram, Xiaohongshu, LinkedIn). Triggered by agent-reach, reach this URL, YouTube transcript, Reddit thread, Bilibili, Xiaohongshu, RSS feed, or…

Stijnman/grok-custom-skills · 138 tokens

drive-github-skill-audit

Compare Google Drive skill definitions with a GitHub skills repository and identify Drive skills not yet published. Use for: audit Drive skills, compare Drive and GitHub SKILL.md files, find unpublished skills, skill-library inventory.

Stijnman/grok-custom-skills · 52 tokens

skill-rubric-reviewer

Reviews SKILL.md files against a 10-dimension quality rubric inspired by the Agent Skills specification. Use for: review skill, skill rubric, audit SKILL.md, score skill quality.

Stijnman/grok-custom-skills · 45 tokens

hitl-approver

Pauses high-risk actions for explicit human approval. Use for: approve this, hitl check, human review needed, confirm before send.

Stijnman/grok-custom-skills · 34 tokens

whatsapp-message-rater

Rates WhatsApp messages for sentiment, urgency, and spam likelihood. Use for: rate this WhatsApp, analyze chat sentiment, score message urgency, whatsapp-auto-responder.

Stijnman/grok-custom-skills · 42 tokens