skills.rest
vpittamp
vpittampCOMMUNITY
Explore all skills by this author →
GitHub

workflow-builder

Automate SW 1.0 workflow authoring, validation, and BFF upsert deployment.

2|Updated Aug 18, 2025
Search Tags:#validation#canvas#authoring#upsert#workflow-builder#sw-1.0
One-click install
npx skills add https://github.com/vpittamp/nixos-config --skill workflow-builder-vpittamp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: workflow-builder
Source: https://github.com/vpittamp/nixos-config/tree/main/shared-skills/workflow-builder
Command: npx skills add https://github.com/vpittamp/nixos-config --skill workflow-builder-vpittamp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) and references (resource) components.

What problem does it solve?

workflow-builder simplifies authoring, validating, and publishing SW 1.0 workflows by bridging spec creation, graph generation, and DB upserts into a single workflow.

Core Features & Use Cases

  • Template-driven SW 1.0 spec authoring with canonical placements and automatic graph mapping.
  • One-click upsert to publish to the BFF and persist the spec, with session-scoped project context.
  • Troubleshooting guidance for agent runtimes, MCP tools, and per-agent dispatch to accelerate development.

Quick Start

Create a SW 1.0 workflow spec in the UI, then run the included upsert script to publish it to the workflow-builder UI canvas.

Frequently Asked Questions about workflow-builder

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

FAQPage Schema
How do I author and validate SW 1.0 workflows?▼

Use template-driven spec authoring to enforce canonical spec structures and guard against rejected slugs during SW 1.0 workflow validation. This process applies automatic graph mapping to prepare your workflow for UI rendering and execution.

What is the best way to publish a workflow spec to the BFF?▼

Publish a workflow spec to the BFF using a one-click upsert operation with session-scoped project context. This bridges spec creation, graph generation, and database persistence directly into the UI canvas for rendering.

How do I upsert workflows directly to the database when the BFF is unavailable?▼

When the BFF is unavailable, you can upsert workflows directly to the database using the provided PSQL fallback path. This ensures your SW 1.0 spec persistence continues without interruption during BFF downtime.

Does workflow-builder handle troubleshooting for agent runtimes and MCP tools?▼

Yes, workflow-builder includes troubleshooting guidance for agent runtimes, MCP tools, and per-agent dispatch to accelerate development. This helps resolve runtime issues while you author and deploy your SW 1.0 workflows.

Can I visualize SW 1.0 workflows in a UI canvas?▼

Yes, you can visualize SW 1.0 workflows in a UI canvas. The tool generates visual graphs from your spec through automatic graph mapping, enabling rendering and execution directly within the workflow-builder interface.

Related Skills

Explore More Software Engineering Skills→
ericstilesericstiles

speckit-clarify

Detect underspecified areas in feature specifications and capture clarification questions.

Community
Advanced
mahmoud20138mahmoud20138
10

microsoft-foundry:microsoft-foundry

Manage Azure AI Foundry agents, models, quotas, and RBAC via Azure CLI.

Community
Advanced
rawvegrawveg
40

ollama

Run and interact with local AI models via the Ollama API.

Community
Advanced
vm-wylburvm-wylbur
1

postgres-optimization

Analyze PostgreSQL databases with postgres-mcp tools to recommend indexes.

Community
Advanced