scenario-workflow-authoring
Use when a task involves creating or editing a Scenario workflow graph through MCP: building an app from a brief, adding or rewiring nodes (models, prompts, approval gates, loops), authoring editor_info, publishing, unpublishing or renaming, importing an exported workflow JSON, migrating a graph bui…
Install / Use
npx skills add scenario-labs/skills --skill scenario-workflow-authoringInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of scenario-workflow-authoring
scenario-workflow-authoring scores 82/100 on our quality scale, 2318th of 2,790 Automation skills we index.
Its SKILL.md is 7.8 KB long, split into 7 sections and no code examples: a thorough specification that gives an agent plenty to work with.
With 1,048 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated 29 days ago, so scenario-workflow-authoring is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-09. Automated pattern scan on 2026-11-09. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
scenario-workflow-authoring compared with similar skills
All 4 of these similar skills score higher than scenario-workflow-authoring; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| scenario-workflow-authoring (this skill)by scenario-labs | 82 | 1.0k | 29d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | today | CLAUDE.md |
Frequently asked questions
- How do I install scenario-workflow-authoring?
- Run
npx skills add scenario-labs/skills --skill scenario-workflow-authoring. The install tabs above show the steps for each supported agent. - Which AI agents does scenario-workflow-authoring work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is scenario-workflow-authoring safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is scenario-workflow-authoring still maintained?
- The repository was last updated 29 days ago, so scenario-workflow-authoring is actively maintained.
Skill content
View source on GitHubname: scenario-workflow-authoring description: "Use when a task involves creating or editing a Scenario workflow graph through MCP: building an app from a brief, adding or rewiring nodes (models, prompts, approval gates, loops), authoring editor_info, publishing, unpublishing or renaming, importing an exported workflow JSON, migrating a graph built in Weavy, ComfyUI, or another node tool, copying a workflow, or turning a prompt chain into an app. Running or pricing a workflow is scenario-workflows. Keywords: node graph, editor_info, CEL." license: MIT
Scenario Workflow Authoring
Overview
A workflow has two representations: editor_info (the editable node graph: nodes, edges,
inputKeys) and flow (the compiled runnable form). Authoring through MCP means writing the whole
editor_info document: there are no per-node editing tools; every change is a read, modify, write
of the full graph through workflow_create or workflow_update. Never hand-write flow:
workflow_publish compiles editor_info into it and flips status to ready. Editing a ready
workflow's editor_info leaves the stale flow running until you publish again.
Read references/editor-info.md before writing any graph: it holds the
node type vocabulary, the node choice doctrine (when an llm node is legitimate), the edge
direction rule, per-node data contracts, and a validated minimal example. Create, update, publish,
copy and delete live in the tool catalog (scenario_tools_search plus the matching executor, see
the scenario skill). workflows_list, workflow_get and workflow_run are direct tools: scope
and dry_run go in their top-level arguments, never an executor wrapper. Running and pricing: the
scenario-workflows skill. If a sibling skill named here is missing from your available skills,
load it with skill_get (Scenario MCP) or ask the user to install it
(https://github.com/scenario-labs/skills#install); unattended, proceed from tool schemas and flag
the gap.
Quick reference
| Step | Call | Notes |
| ----------------- | ------------------------------------ | ---------------------------------------- |
| 1. Study a graph | workflow_get on a working workflow | Copy the shape, never ids |
| 2. Model contract | model_schema_get | Handle names and required inputs |
| 3. Author | editor_info + inputs_definition | Per the reference file |
| 4. Create | workflow_create | Non-atomic, see below |
| 5. Publish | workflow_publish | Compiles flow; one output pin required |
| 6. Validate | workflow_run with dry_run=true | Prices and runs the real validator |
workflow_create is two calls under the hood: a failed create may still have created a draft whose
id is in the error. Recover with workflow_update on that id; re-creating duplicates. Seed step 1
with workflow_get: it returns the full graph of any workflow whose id you have, public ones
included (an id or app URL the user supplies, or your own team's from workflows_list). To find a
public template, use search with target="workflows", public=true, a keyword query,
limit=3, and your scope; for example, query="image" with raw filter: 'status = "ready"'. Read
ids from workflows, then fetch the chosen graph with workflow_get; search hits are summaries,
not graph documents. Workflow search supports keyword text and filters only, so omit image and
semantic options. Use workflows_list for browsing your saved workflows.
scripts/fetch_workflow_examples.py bulk-exports trimmed
featured-workflow graphs for maintainers (setup in its header).
Worked example: a text-to-image app
recommendwithcapability: "txt2img"and the user's brief asprompt, following thescenarioskill'snext_stepdiscipline, thenmodel_schema_get: its input names become the model node's handle names, and itsrequiredflag marks what must be wired. Usesearchinstead when the user names a model.- Author
editor_info:text1withdata.isInput: true,model1withtype: "model",data.modelIdanddata.isOutput: true, one edge frommodel1's input totext1's output (edges name the downstream node assource, see the reference),inputKeys: ["text1"]. workflow_createwithname,editor_info, andinputs_definitionnamingtext1as a string input. The published input key is the node id, which is why run inputs have names liketext1.workflow_publish, thenworkflow_runwithdry_run=trueto validate and price. Fix the graph and re-publish if validation fails.
One output per item needs a loop
A multiple-asset input wired straight into a generative model's reference field is one generation
conditioned on every item at once: ten product shots in come back as one image blending them, not
ten edits. Field names and cardinality are per model, so read them off model_schema_get
(array: true marks a list), and read the field's description as well: a few utility tools take a
list and return one output per item, which needs no loop. When each item needs its own result, put
the model inside a forEach over the list and read the outputs from the forEachEnd (wiring in the
reference's forEach section); keep the direct wiring only when the items are meant as joint
references for a single output. Inside the loop the current item feeds an array field as a one-item
list. forEach runs one billed model job per item, but the dry run prices one iteration whatever
the list length (observed: one quote for one or two items, twice that billed for two), so multiply
the quote by the item count before quoting the user.
Migrating a graph from another node tool
A pipeline exported by Weavy, ComfyUI, or another node editor does not import: only Scenario's own export round-trips. It is translated node by node, then created, published, and dry-run as above. The mapping table, member resolution, and the report the user gets are in references/foreign-graph-import.md; read it before touching such an export, since its first rule is to reduce the file to a table locally rather than paste it into the conversation.
Common mistakes
- Writing UI palette names as node types: persisted types are the camelCase vocabulary in the
reference, and every generator is
type: "model". - Wiring edges producer to consumer: persisted edges point the other way.
- Expecting an
editor_infoupdate to change a live app without re-publishing. - Retrying a failed
workflow_createwith a second create instead ofworkflow_updateon the id from the error. - Wiring a batch of assets into one model input and expecting one output per item: that is one
generation over all of them; loop with
forEach. - Publishing with no output pin, or with
data.isOutputon a text or asset node: publish fails withcompiled to an empty flow. The output pin goes on themodel,llm, orforEachEndnode that produces the deliverable. Input pins are optional: a graph with its prompt built in publishes and runs with no inputs. - Gating a text node in front of a builder or model: a branch skips only the node wired to its
handle, so the consumer stays pending and the job never completes. Gate the node that does the
work, or use a CEL ternary for conditional prompt text, per the reference's
ifElsesection. - Double-quoted CEL literals: they evaluate but corrupt the canvas editor, single quotes only.
- Sending
workflow_idtoworkflow_copy: get, update, publish, run and delete takeworkflow_id, but copy takessource_workflow_id; the copy inherits everything verbatim and needs its own publish.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
