workflow-canvas-reasoning

Interprets workflow canvas edits as structural diffs and proposes ranked intent readings with evidence.

Updated Sep 6, 2026
One-click install
npx skills add https://github.com/rickvang/Persona-Library --skill workflow-canvas-reasoning-rickvang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: workflow-canvas-reasoning
Source: https://github.com/rickvang/Persona-Library/tree/main/.agents/skills/workflow-canvas-reasoning
Command: npx skills add https://github.com/rickvang/Persona-Library --skill workflow-canvas-reasoning-rickvang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When someone rearranges a workflow on a visual canvas, the raw edits are ambiguous: a moved card may be layout noise, a reordering, or a tier change, and displaced neighbors are consequences rather than intentions. This Skill reads the change as a structural diff between two graph states and proposes ranked interpretations of intent, so a person can accept, correct, or discard a reading instead of reconstructing it by hand. ## Core Features & Use Cases - Structural diff classification: Distinguishes additions, removals, tier reclassification, reordering, connection changes, reroutes, branches, and orphaned nodes, while marking pure layout moves as non-semantic. - Gesture attribution: Attributes index shifts caused by a single move to the gesture that produced them, so displacement is never reported as separate intent. - Ranked readings with evidence: Ranks intent hypotheses by how well the canvas structure determines them, names the specific structural facts behind each reading, and lists open questions the canvas cannot answer. - Use Case: A user drags a step between two connected steps and removes another. The Skill reports the insertion as a well-determined reading, flags the removal as ambiguous (deletion vs. absorption), and hands off a packet with status needs_clarification rather than writing anything. ## Quick Start Ask the assistant to interpret the recent changes made to the workflow canvas and explain what they imply for the underlying workflow map.

Frequently Asked Questions about workflow-canvas-reasoning

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I interpret changes made to a workflow canvas?▼

Activate the skill after rearranging a workflow on the canvas. It diffs the committed source graph against the current graph, classifies the structural changes, and returns ranked intent readings with named evidence and open questions.

How does the skill tell layout moves from meaningful workflow edits?▼

A card moved without changing its order or tier is recorded as layout and marked non-semantic. Only additions, removals, tier changes, reordering, and connection changes are classified as interpretable structural diffs.

Can this skill apply an accepted reading to live workflow records?▼

No. The prototype is strictly read-only against live content and never writes Persona, Skill, Tool, Playbook, or workflow records. Interpretation and mutation are separate steps with separate permission.

What happens when a canvas edit is ambiguous?▼

Ambiguous gestures produce open questions instead of confident answers. For example, a removal cannot distinguish deletion from absorption, so the output packet is marked needs_clarification until a person resolves it.

Why does moving one card not count as reordering its neighbors?▼

Moving one card shifts the index of every card it passes, and those shifts are consequences of the gesture, not separate intentions. Ordering is measured only among nodes that stayed in place, so displacement never appears as intent.