Review every Power Automate flow in your solution — in seconds.

PowerCAT OverFlow is an AI-powered plugin and viewer that audits every cloud flow in a Power Platform solution against Microsoft's authoring guidelines, then renders each flow as an interactive diagram with risks, categories and remediation hints.

PowerCAT-Overflow.html — Stress_028_UntilLoop
See it in action

An interactive review — not a static report.

Two views you'll use every day: a solution-wide executive summary with category roll-ups and top risks, and a per-flow diagram with findings overlaid on the actions that triggered them.

Solution Overview with executive summary, category roll-up, and top risks across flows
Solution Overview

Executive summary, category roll-ups, top risks

Open any reviewed solution and the first screen tells you everything — total flows, action counts, the three biggest priorities, and severity-tagged risks per category.

Flow detail view with JSON editor, interactive diagram, and Flow Evaluation Report sidebar
Flow Detail

Diagram, JSON, and Flow Evaluation Report side-by-side

Click any flow to see its actions as nodes, the raw JSON live-bound to the diagram, and a Maintainability / Security / Performance report with remediation hints linked to Microsoft Learn.

How it works

Two parts that work together.

A Copilot CLI plugin scans your solution and writes a single findings file. The hosted viewer turns that file into an interactive review you can share with anyone.

1. The plugin (skill)

A GitHub Copilot CLI skill that scans every flow in a Power Platform solution against Microsoft's authoring guidelines and writes a single [Solution].findings.json next to your file.

Get the plugin ↗

2. The viewer (app)

A hosted single-page app that loads a solution and its findings and renders each flow as an interactive diagram — with risks, categories, and remediation hints overlaid on every action.

Launch the app ↗

3. The demo

A pre-configured viewer with a real solution and findings already loaded. Open it, click around, get the feel of OverFlow in 30 seconds — no install required.

Open the demo ↗
What you get

Designed for makers and reviewers alike.

Solution-level roll-ups for the people who need the big picture; flow-level diagrams and remediation hints for the people who write and fix the flows.

Solution overview

Category roll-ups and top risks across the whole solution, surfaced the moment you open a review.

Interactive flow diagrams

Every action rendered as a node, with findings overlaid on the actions that triggered them.

Filter by severity

Slice findings by severity (Critical / Warning / Info / Pass), category, or action type — without leaving the page.

Inline code editor

Click any action to view its code. Edit and the diagram updates immediately — perfect for walkthroughs.

Microsoft-authored guidelines

Findings come from a curated list of Power Automate authoring guidelines, fetched live from the marketplace repo.

Shareable artifacts

The findings JSON pairs with your solution .zip — hand both to a colleague and they get the same interactive review.

Documentation

From zero to first review in under five minutes.

Install the plugin once, drag-and-drop a solution into Copilot CLI, and the viewer opens with findings overlaid — automatically.

Prerequisites

Before you install the plugin, make sure the following are in place.

RequirementWhy you need it
GitHub Copilot licenseRequired to use Copilot CLI and run skills (Business or Enterprise plan with CLI access).
GitHub Copilot CLIThe command-line host that loads plugins and runs skills. Install per the official Copilot CLI docs.
Power Platform solution (.zip)An unmanaged or managed export containing a Workflows/ folder with at least one cloud flow.
Modern browserMicrosoft Edge, Chrome, or Firefox to open the hosted PowerCAT OverFlow viewer.
Internet accessThe skill fetches the authoritative review source list and opens the GitHub Pages viewer.
Heads-up on licensing. Copilot CLI access is gated by your GitHub Copilot subscription. If the copilot command isn't available or returns an authentication error, confirm with your admin that CLI usage is enabled for your seat.

Install the PowerCAT OverFlow plugin

Run these commands inside an active GitHub Copilot CLI session. The first two only need to be run once; afterwards the plugin auto-updates when the marketplace publishes a new version.

  1. Open a Copilot CLI session

    Open a terminal and start Copilot CLI:

    $ copilot
  2. Add the Power CAT Skills marketplace

    Register the Power CAT marketplace so Copilot CLI can discover its plugins:

    /plugin marketplace add https://github.com/microsoft/Power-CAT-Skills
  3. Install the powercat-overflow plugin

    Install the plugin from the marketplace you just added:

    /plugin install powercat-overflow@power-cat-skills

    Confirm the install when Copilot CLI prompts you. The skill is now available in any Copilot CLI session.

Verify the install. Type /plugin list and confirm powercat-overflow appears with the status "installed".

Review a solution with the plugin

Once installed, the skill runs end-to-end: it scans every flow, writes a findings JSON next to the uploaded solution, opens the hosted viewer in your browser, and attaches both files for you.

  1. Export a Power Platform solution

    In the Power Apps maker portal, export the solution that contains the flows you want to review. Either Managed or Unmanaged is fine, as long as a Workflows/ folder is present. Save the .zip somewhere reachable from your terminal.

  2. Trigger the skill

    Inside an active Copilot CLI session, drag-and-drop or attach the solution .zip, then type a natural prompt:

    review my solution

    Other prompts that trigger the same skill:

    powercat overflow
    audit Power Automate solution
    check this solution against guidelines
  3. Let the plugin do its work

    The skill will:

    • Fetch the authoritative review source list from microsoft/power-cat-skills.
    • Unpack the solution and locate every flow under Workflows/.
    • Score each flow against the guidelines and classify findings as Critical, Warning, Info, or Pass.
    • Write [SolutionName].findings.json next to your uploaded solution.
    • Open the hosted viewer and attach both files.
  4. Explore the findings in the viewer

    Once the viewer loads, you can browse all flows in the left-hand nav, open the Solution Overview to see category roll-ups and top risks, click any flow to see its actions as a diagram with findings overlaid, filter by severity / category / action type, click on findings to reveal the related action, and click any action to view or edit its code — the diagram updates immediately.

Output location. The findings JSON is written to the same folder as the solution .zip you attached. Keep them paired — the viewer expects both files together.

Load a solution and findings manually

You can also use the viewer on its own, no Copilot CLI required. This is useful when someone shares a solution and findings pair with you, or you want to re-open a previous review.

  1. Open the viewer

    In any modern browser, open microsoft.github.io/power-cat-skills/PowerCAT-Overflow.html.

  2. Load the solution file

    On the welcome window, in the Required step, click Open solution (.zip) and pick your Power Platform solution export. The viewer reads the Workflows/ folder, parses each flow, and renders the Solution Overview.

  3. Load the findings file (optional)

    In the Optional step, click Open findings (.json) and pick the matching [SolutionName].findings.json. The viewer overlays findings on each flow and unlocks the Top Risks and Category Roll-up cards in the Solution Overview.

  4. Swap files at any time

    You can re-open the file dialogs from the top bar to swap in a different solution or different findings file without reloading the page. The viewer redraws the navigation and overview automatically.

Troubleshooting

Plugin not found
Re-run /plugin marketplace add microsoft/power-cat-skills, then /plugin install powercat-overflow@power-cat-skills.
Skill fails fetching the source list
The skill needs internet access to reach the authoritative guidelines file. Check your network, then retry.
Viewer shows the welcome window after loading
The solution .zip likely has no Workflows/ folder. Export a solution that contains at least one Power Automate cloud flow.
Top Risks card stays empty
Findings JSON is missing or doesn't match the loaded solution. Re-run the skill, or load the matching [SolutionName].findings.json manually.
Additional resources

Everything you need to dig deeper.

Source, samples, and demo builds — bookmark these for reviews, walkthroughs, and customer demos.