workflow-editor

Automate validated edits to ACP workflow files with rollback guidance.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/stackrox/ambient-workflows --skill workflow-editor-stackrox
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-editor
Source: https://github.com/stackrox/ambient-workflows/tree/main/.claude/skills/workflow-editor
Command: npx skills add https://github.com/stackrox/ambient-workflows --skill workflow-editor-stackrox

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps teams safely modify ACP workflows by guiding users through validated, minimal edits that preserve structure, naming, and documentation.

Core Features & Use Cases

  • Guided, phase-based editing that verifies target workflow existence and file naming before changes.
  • Minimal, targeted edits across agents, commands, ambient.json, and documentation with automatic validation.
  • Safety-focused tooling with JSON/schema validation, change summaries, and rollback guidance.

Quick Start

Initiate edits by confirming the target workflow, then specify the exact changes to apply in small, validated steps.

Frequently Asked Questions about workflow-editor

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

FAQPage Schema
How do I safely edit ACP workflow files without breaking JSON structure?

To safely edit ACP workflows, apply validated, minimal changes to agents, commands, and ambient.json files. The process verifies target workflow existence and file naming conventions before applying changes, ensuring JSON validity and preserving structural integrity.

What is the best way to modify ambient.json and workflow documentation?

The best way to modify ambient.json and documentation is through guided, phase-based editing that enforces JSON and schema validation. This approach applies targeted edits while automatically generating change summaries to verify modifications.

Can I rollback invalid workflow changes if JSON validation fails?

Yes, you can rollback invalid workflow changes using built-in rollback guidance. If JSON or schema validation fails during the editing process, the safety-focused tooling provides error handling and instructions to revert the workflow directory to its previous state.

Does ACP workflow editing require existing directory structures?

Yes, ACP workflow editing requires an existing workflows/ directory structure. The guided editing process first confirms the target workflow existence and verifies file naming conventions before allowing any modifications to agents, commands, or ambient.json files.

Why do my workflow edits fail naming convention checks?

Workflow edits fail naming convention checks when modified agents or commands do not match the existing structural standards. The editing process verifies target workflow existence and enforces strict file naming validation before applying any changes.

When should I use automated validation for workflow editing?

You should use automated validation for workflow editing whenever modifying agents, commands, ambient.json, or README files. It enforces JSON validity, ensures minimal verifiable edits, and provides change summaries to maintain documentation and structural consistency.