workflow-edit

Apply structured frontmatter edits to workflow definition files.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/hollis-labs/volon --skill workflow-edit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-edit
Source: https://github.com/hollis-labs/volon/tree/main/plugins/workflow-author/skills/workflow-edit
Command: npx skills add https://github.com/hollis-labs/volon --skill workflow-edit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a deterministic, safe way to update workflow frontmatter without risking accidental edits to the workflow body, ensuring metadata stays accurate and auditable.

Core Features & Use Cases

  • Structured frontmatter edits: Apply explicit field=value updates for description, status, tags, invocation, and version.
  • Validation and guardrails: Enforces allowed status transitions, validates frontmatter against the workflow schema, and redirects deprecation flows to the dedicated deprecate action.
  • Audit-friendly updates: Automatically updates updated_at, summarizes changed fields, and avoids modifying body sections (Steps, Invariants, Evidence).
  • Use case: Update a draft workflow's description and tags before promoting it to active while preserving the authored Steps and Invariants.

Quick Start

Invoke /workflow-edit my-workflow status=active description=Updated description to apply the specified frontmatter changes to workflows/user/my-workflow.md.

Frequently Asked Questions about workflow-edit

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

FAQPage Schema
How do I safely edit workflow frontmatter without modifying the body sections?

Workflow frontmatter edits can be safely applied by validating fields against the authoring schema and writing changes atomically, which preserves body sections like Steps and Invariants while updating metadata such as description, status, and tags.

What is the best way to update a workflow status to active?

Updating a workflow status to active requires enforcing allowed status transitions within the frontmatter validation schema, ensuring the change is permitted before applying the structured edit and writing the file atomically.

How do I validate YAML frontmatter against a workflow authoring schema?

YAML frontmatter validation checks structured fields like description, status, tags, invocation, and version against the workflow authoring schema, ensuring only compliant metadata changes are written to the workflow definition file.

Can I update workflow tags and description while preserving authored Invariants?

Yes, updating workflow tags and description targets only the frontmatter metadata, automatically preserving authored body sections including Invariants, Steps, and Evidence without risking accidental modifications to the workflow content.

What happens when I try to edit a deprecated workflow's metadata?

Editing a deprecated workflow's metadata redirects the deprecation flow to a dedicated deprecate action, preventing standard metadata edits and ensuring the workflow lifecycle is managed through the correct validation guardrails.

Does updating workflow metadata automatically refresh the updated_at field?

Updating workflow metadata automatically refreshes the updated_at field to the current date and summarizes changed fields, providing an audit-friendly record of modifications when validations pass and changes are written atomically.