workflow-update

Update Sparkflows workflows by applying deterministic node and edge changes.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/sparkflows/vscode --skill workflow-update-sparkflows
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-update
Source: https://github.com/sparkflows/vscode/tree/main/workflow-update
Command: npx skills add https://github.com/sparkflows/vscode --skill workflow-update-sparkflows

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) components.

What problem does it solve?

Updates an existing Sparkflows workflow by applying user-specified changes to its nodes and edges, enabling rapid evolution of data pipelines without recreating workflows from scratch.

Core Features & Use Cases

  • Applies a deterministic, conflict-free update sequence (remove edges, remove nodes, add nodes, add edges, update parameters) to preserve graph integrity.
  • Supports common modification scenarios, such as adding a new node, reconfiguring node parameters, or rerouting connections to optimize pipelines.
  • Works with a workflow ID to fetch, modify, and re-import updated workflows into the Sparkflows server when requested.

Quick Start

Update an existing Sparkflows workflow by describing precise changes to apply (e.g., "update workflow 1234 to add a filter after node 2" or "rename node 5 input path to s3://...").

Frequently Asked Questions about workflow-update

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

FAQPage Schema
How do I update an existing Sparkflows workflow without recreating it from scratch?

To update an existing Sparkflows workflow, provide the workflow ID and describe the precise changes to apply to its nodes and edges. The update executes in a deterministic sequence to preserve graph integrity without requiring a full recreation.

What is the safest order for modifying nodes and edges in a data pipeline?

The safest order for modifying nodes and edges is deterministic: remove edges, remove nodes, add nodes, add edges, and finally update parameters. This specific sequence prevents broken connections and preserves graph integrity during pipeline updates.

Can I reconfigure node parameters and reroute connections in Sparkflows dynamically?

Yes, you can reconfigure node parameters and reroute connections by specifying the target workflow ID and the desired changes. The update process applies these modifications safely to adapt your data pipelines dynamically.

What do I need to modify a Sparkflows workflow using automation?

To modify a Sparkflows workflow using automation, you need the specific workflow ID to fetch the existing pipeline. You also need the requests library installed to handle the API interactions for re-importing the updated workflow.

Why does my workflow update fail when adding new nodes to a Sparkflows pipeline?

Workflow updates may fail if nodes are added before edges are properly removed or rerouted. The system enforces a strict deterministic update order to prevent such conflicts, ensuring edges are removed before any structural additions occur.

Does the workflow-update script work with the Sparkflows server directly?

Yes, the script works with the Sparkflows server by using the workflow ID to fetch, modify, and re-import the updated workflow. This integration enables rapid evolution of data pipelines directly within the server environment.