CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

workflow-runner

在 Claude Code / OpenClaw / Cursor 中直接运行 agency-orchestrator YAML 工作流——无需 API key,使用当前会话的 LLM 作为执行引擎。当用户提供 .yaml 工作流文件或要求多角色协作完成任务时触发。

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

High

Do not use without reviewing

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A tightly written, highly actionable orchestration procedure: five sequenced steps with explicit tool usage (Read/Bash/Agent/Write), parallel-layer scheduling, exact commands, paths, and output formats, plus a HARD-GATE checklist and failure-recovery rules. Weaknesses are minor — slight redundancy with the description's scenario bullets and a monolithic single-file layout that could offload the YAML schema and output-format references.

DimensionReasoningScore

Conciseness

The body is dense operational content (YAML field schema, ordered directory fallbacks, exact install commands, metadata.json template) with no explanations of concepts Claude already knows. Minor trimmable parts remain — the "适用场景" bullets restate the description's trigger conditions and some display-format boilerplate could be tightened — fitting anchor 4 rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

Fully executable, copy-paste-ready guidance: "用 Bash `test -d` 按以下顺序检查" with four ordered fallback locations, the exact user-facing error message with "git clone --depth 1 https://github.com/jnMetaCode/agency-agents-zh.git" / "npm install agency-agents-zh", the exact output layout ".ao/output/{工作流名称}-{YYYY-MM-DD}/", a complete metadata.json example, and a fully specified subagent prompt structure including the verbatim instruction text.

5 / 5

Workflow Clarity

Five explicitly ordered steps ("按以下顺序执行,不要跳步") with explicit topological layering rules, a pre-execution plan display, validation checkpoints (required inputs trigger "立即向用户询问,不要猜测", agents-dir existence check, HARD-GATE "必须先 Read 再执行"), a <HARD-GATE> checklist, and a 故障处理 section with error-recovery rules (failed step → skip dependent downstream steps, continue independents). Matches anchor 5's sequence + validation + feedback loops + checklist; the only uncovered edge cases (cyclic depends_on, malformed YAML) are too minor to drop it to anchor 4.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and the single ~178-line SKILL.md is well-sectioned (适用场景 / 执行流程 5 步 / 重要规则 / 快捷模式 / 故障处理) with everything inlined being runtime-operational. Minor organization gap: the YAML schema block and the output-format/metadata blocks could be split into a reference file to slim the main body — good structure, not the fully split, one-level-deep reference layout of anchor 5.

4 / 5

Total

18

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A concise, third-person description that states a concrete capability (running agency-orchestrator YAML workflows inside Claude Code/OpenClaw/Cursor via the session LLM, no API key) with explicit, natural trigger conditions including the .yaml extension. It is specific, complete, and mostly distinct; the only gaps are that the no-YAML quick mode is unmentioned and the multi-role trigger is somewhat broad.

DimensionReasoningScore

Specificity

"直接运行 agency-orchestrator YAML 工作流——无需 API key,使用当前会话的 LLM 作为执行引擎" names a concrete domain, action, and delivery mechanism with no vague language. It falls short of anchor 5 because it covers a single action and omits the no-YAML quick-mode capability stated in the body, but sits clearly above anchor 3's bare '1-2 concrete actions' level given its precision.

4 / 5

Completeness

It explicitly answers both what ("直接运行 agency-orchestrator YAML 工作流...使用当前会话的 LLM 作为执行引擎,无需 API key") and when ("当用户提供 .yaml 工作流文件或要求多角色协作完成任务时触发") with concrete trigger phrases — a direct match for the anchor-5 pattern. It is written in third person, so no voice penalty applies.

5 / 5

Trigger Term Quality

Includes natural phrases users would say — "运行...工作流", "多角色协作完成任务", and the file extension in ".yaml 工作流文件". A few natural synonyms (e.g. 执行, 编排, agent 协作) are missing, matching anchor 4 ('good keyword coverage; a few natural terms missing') rather than comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

"agency-orchestrator YAML 工作流" plus the ".yaml 工作流文件" trigger carves a distinct niche with minimal conflict risk. However, "要求多角色协作完成任务" is a fairly broad trigger with minor overlap risk against other multi-agent orchestration skills, fitting anchor 4 rather than 5.

4 / 5

Total

17

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository

jnMetaCode/superpowers-zh

Path

skills/workflow-runner/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.