workflow-editor

Validate and edit ACP workflows under workflows/ with JSON checks.

3|38|Updated Nov 6, 2025
One-click install
npx skills add https://github.com/ambient-code/workflows --skill workflow-editor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-editor
Source: https://github.com/ambient-code/workflows/tree/main/.claude/skills/workflow-editor
Command: npx skills add https://github.com/ambient-code/workflows --skill workflow-editor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides developers and operators through safe, validated edits to existing ACP workflows, preserving structure, validating names and JSON, and updating documentation when needed.

Core Features & Use Cases

  • Guided requirements gathering: interactively collects exactly what to change through targeted questions.
  • Strong validation: enforces valid workflow naming, file paths, JSON schemas, and consistent structure across agents, commands, ambient.json, and README.
  • Minimal, auditable edits: applies only the requested changes with traceable summaries and no large rewrites.

Quick Start

Identify the target workflow, confirm the exact files to edit, and proceed with minimal, validated changes.

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 workflows without breaking the JSON structure?

To safely edit ACP workflows, apply minimal changes to agents, commands, and ambient.json files while enforcing JSON schema validation and stepwise confirmation to preserve structure and prevent breaking changes.

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

The best way to update ambient.json and workflow documentation is through guided requirements gathering that interactively collects exact changes, validates file paths, and updates the README to maintain consistent structure.

Can I modify agents and commands in workflows without doing a full rewrite?

Yes, you can modify agents and commands without a full rewrite by applying only the requested minimal edits, generating traceable summaries, and validating naming conventions to ensure auditable changes.

How does stepwise confirmation work when validating workflow naming and file paths?

Stepwise confirmation works by interactively asking targeted questions to gather exact requirements, then checking workflow naming and file paths against validation rules before applying any modifications.

Are there limitations to editing ACP workflows under the workflows directory?

A limitation of editing ACP workflows is that the process requires minimal edits and strict JSON validation, meaning large rewrites or unvalidated structural changes are restricted to prevent breaking the workflow.