About manage-flows
A skill for managing flow lifecycles through publishing and testing, batch actions, inventory reports, health checks, and incident response. It uses FlowAgent MCP tools, with CLI commands for operations those tools do not cover.
Key features
- 01Publish flows and verify runs
- 02Batch publish, disable, or delete flows
- 03Report environments and flow inventory
- 04Check run history and failure rates
- 05Cancel runaway runs and resubmit eligible runs
Use cases
- 01Test a flow immediately after publishing
- 02Disable or remove several flows
- 03Review flow states across environments
- 04Investigate repeated failures or queued runs
MCP support
Uses FlowAgent MCP tools for flow operations such as publishing, running, listing, and checking histories. CLI shell commands are reserved for CLI-only operations or when MCP tools are unavailable.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ microsoft/ power-platform-skills --skill manage-flowsAfter installing, type/manage-flowsin Claude Code to confirm it loaded.
Details
From the project READMEFlow Lifecycle Manager
Autonomous agent for flow lifecycle operations: publish-and-test, batch operations, inventory reports.
Tools
This skill uses the FlowAgent MCP tools, referred to by bare name (clients
surface them as mcp__flowagent__<tool> in Claude Code or flowagent-<tool> in
Copilot CLI). Use CLI shell commands (local engine build only) for CLI-only
operations (connection lifecycle, sharing, solutions/admin) or when no MCP tools
are present.
Capabilities
1. Publish-and-Test Cycle
- Call
publish_flowto enable - Call
run_flowwithwait: trueandtimeout: 30to trigger and wait for completion - Report: pass/fail, duration, action statuses
2. Batch Operations
For multiple flows (IDs from $ARGUMENTS or from list_flows):
- Batch disable: Call
disable_flowper flow - Batch delete: Call
delete_flowper flow (confirm first) - Batch publish: Call
publish_flowper flow Report per-item success/failure.
3. Inventory Report
- Call
list_environmentsto get environments - Call
list_flowson each (or specified) environment - Produce summary: flow counts by state, trigger types, recent modifications
4. Health Check
For each flow in an environment:
- Call
get_run_historywithtop: 5 - Count Succeeded vs Failed runs
- Flag flows with >50% failure rate Report: flow name, success rate, last run status, last failure error.
5. Incident Response (runaway runs)
When a flow is misfiring with many queued runs:
- Call
cancel_all_runsto bulk-cancel every Running/Waiting run (uses the Dataverse bulk action for solution & modern non-solution flows, per-run fallback otherwise). PassturnOff: trueto also disable the flow while the root cause is fixed. - After fixing,
resubmit_runthe affected runs (note: only self-invoked runs are resubmittable per PA policy).