diagnose-flow
starsforks
How to install diagnose-flow?
microsoft/power-platform-skills/diagnose-flow
$npx -y skills add microsoft/power-platform-skills --skill diagnose-flowDeep autonomous diagnosis of a failed flow run. Provide environment, flow, and run IDs. Use when the user asks to diagnose or deeply investigate a specific failed flow run.
SKILL.md
| 1 | # Deep Flow Diagnostic Agent |
| 2 | |
| 3 | You are an autonomous diagnostic agent. Given environment, flow, and run IDs, perform a comprehensive failure analysis. |
| 4 | |
| 5 | ## Input |
| 6 | |
| 7 | Parse `$ARGUMENTS` for: environment ID, flow ID, run ID. |
| 8 | |
| 9 | ## Tools |
| 10 | |
| 11 | This skill uses the **FlowAgent MCP tools**, referred to by bare name (clients |
| 12 | surface them as `mcp__flowagent__<tool>` in Claude Code or `flowagent-<tool>` in |
| 13 | Copilot CLI). If MCP tools aren't available, run `/setup` to wire the FlowAgent |
| 14 | MCP server. |
| 15 | |
| 16 | ## Workflow |
| 17 | |
| 18 | 1. **Triage with `diagnose_run`**, then gather full context in parallel: |
| 19 | - `diagnose_run` — classified failed/timed-out actions with a remediation each (start here) |
| 20 | - `get_run_details` for overall run status |
| 21 | - `get_run_actions` for the full action-level execution trace |
| 22 | - `get_flow` for definition context |
| 23 | - For a failed loop, `get_run_action_repetitions` on an action **inside** the loop (the container returns none) to find the failing iteration |
| 24 | |
| 25 | 2. **Build execution graph**: Map each action's `runAfter` dependencies. Identify parallel branches. |
| 26 | |
| 27 | 3. **Identify failed actions**: Filter for status != Succeeded. Classify each as: |
| 28 | - **Root failure**: dependencies all Succeeded but this action failed |
| 29 | - **Cascading skip**: skipped because a dependency failed |
| 30 | |
| 31 | 4. **Analyze each root failure** against common patterns: |
| 32 | - Authorization/Connection errors |
| 33 | - Expression evaluation failures |
| 34 | - HTTP 4xx/5xx from external services |
| 35 | - Timeout errors |
| 36 | - Parameter validation failures (empty required fields, wrong enum values) |
| 37 | - Action type mismatches (OpenApiConnection vs OpenApiConnectionWebhook) |
| 38 | |
| 39 | 5. **Cross-reference with definition**: Check if the action's parameters, connection references, or expressions have issues visible in the definition. |
| 40 | |
| 41 | 6. **Write diagnosis report** with: |
| 42 | - Execution timeline |
| 43 | - Root cause identification |
| 44 | - Specific fix with code changes |
| 45 | - Confidence level (high/medium/low) |
| 46 | |
| 47 | 7. **Optionally generate fixed definition**: If the fix is a definition change, apply it with `edit_flow` (surgical, one action/parameter) — fall back to `update_flow` only for large rewrites. |
People who liked this also viewed
6 picksType
- azure-diagnosticsDebug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe triage. WHEN: debug production issues, troubleshoot app service, app service high CPU, app service deploySkillsJul 2026
- systematic-debuggingUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesSkillsJul 2026
- safe-debugRigor Debug / Rigor Audit skill for deep learning research work. Use when the user pastes a traceback, terminal error, CUDA OOM, checkpoint load failure, shape mismatch, NaN loss symptom, or training SkillsMay 2026
- explore-runRigor Improve / Rigor Explore run leaf skill for bounded exploratory evidence in deep learning research repositories. Use when the researcher explicitly authorizes exploratory runs such as small-subseSkillsMay 2026
- minimal-run-and-auditRigor Run skill for README-first deep learning repo reproduction. Use when the task is specifically to capture or normalize evidence from the selected smoke test or documented inference or evaluation SkillsMay 2026
- insforge-debugUse when diagnosing problems in an InsForge project — reactive failures (SDK error object, HTTP 4xx/5xx, gateway timeout 502/503/504, edge function failure or timeout, login/OAuth/auth errors, RLS denSkillsJul 2026
