Connections
Connections (edges) define relationships between nodes. They give your graph semantic meaning — not just “these nodes are linked” but how they relate.
Connection types
Skrptiq supports seven connection types. Each one carries a specific meaning about how two nodes relate.
| Type | Label | Meaning | Typical usage |
|---|---|---|---|
uses | Uses | The source node actively uses the target | Skill → Prompt, Workflow → Skill |
depends_on | Depends on | The source cannot function without the target | Skill → Service, Prompt → Source |
derived_from | Derived from | The source was created from or inspired by the target | Prompt → Prompt, Document → Source |
references | References | The source mentions or links to the target | Document → Prompt, Skill → Document |
tagged | Tagged | The source is categorised by the target | Any node → Tag-style node |
runs_on | Runs on | The source executes on or via the target | Workflow → Service, Skill → Service |
requires | Requires | The source needs the target as a prerequisite | Workflow → Skill, Skill → Asset |
Visual styles
Connections render differently depending on type:
usesedges are animated with a dashed green stroke that flows along the line. This makes the most common relationship instantly visible.- All other edges are static lines with a dark slate stroke (
#334155). - Labels appear on every edge, showing the human-readable label (e.g. “Depends on”, “Derived from”).
- Line shape is smooth-step (right-angled corners with rounded bends), not straight or bezier.
Viewing connections
When you open a node in the editor sidebar, the Connections section lists every connection involving that node:
- Outgoing (→) connections show the edge type and the target node, with the target’s type badge.
- Incoming (←) connections show the edge type and the source node, with the source’s type badge.
- Each connection row has a navigate button that selects and zooms to the connected node.
This gives you a quick way to traverse your graph without losing context — click through related nodes one at a time.
Creating connections
There are three ways to create connections:
From the expanded editor
- Open a node and click Expand to open the full editor modal.
- In the middle column (Connection Manager), click Add Connection.
- Search for the target node by title or description.
- Select the edge type from the dropdown (uses, depends on, references, etc.).
- Click to create the connection.
For workflow nodes, use the Add Step button instead — this shows only skills and prompts, and automatically assigns the next step position in the pipeline.
From the list view
In list view, expand a node’s row to reveal its connections section. Click Add Connection to open the inline connection adder:
- Search for a target node by title.
- Filter by type using coloured chip buttons to narrow results to specific node types.
- Choose an edge type from the dropdown.
- Click a search result to create the connection.
Existing connections in the expanded row show hover-visible delete buttons for quick removal.
From the workflow wizard
The Workflow Wizard creates uses, runs_on, and requires connections automatically when you assign components and services to workflow steps.
Deleting connections
To remove a connection:
- Editor sidebar — find the connection in the Connections section and click the delete button.
- Expanded editor — use the Connection Manager’s delete buttons on existing connections.
- List view — expand a node’s row, hover over a connection, and click the delete button that appears.
The connection is removed immediately. Neither node is deleted — only the relationship between them.