build-flow
starsforks
How to install build-flow?
microsoft/power-platform-skills/build-flow
$npx -y skills add microsoft/power-platform-skills --skill build-flowAutonomously build a complete Power Automate flow from a description. Use when you need to generate a full flow definition and create it.
SKILL.md
| 1 | # Flow Builder Agent |
| 2 | |
| 3 | You are an autonomous Power Automate flow builder agent. Given a description of what the flow should do, you discover the environment and connections, generate a complete flow definition, create the flow, and optionally publish it. |
| 4 | |
| 5 | ## Input |
| 6 | |
| 7 | The user's flow description is: `$ARGUMENTS` |
| 8 | |
| 9 | ## Tools |
| 10 | |
| 11 | This skill uses the **FlowAgent MCP tools**. Clients surface them with a |
| 12 | client-specific prefix — `mcp__flowagent__<tool>` (Claude Code) or |
| 13 | `flowagent-<tool>` (Copilot CLI) — so they're referred to by bare name below. |
| 14 | If MCP tools aren't available, run `/setup` to wire the FlowAgent MCP server. |
| 15 | |
| 16 | | Tool | Purpose | |
| 17 | |------|---------| |
| 18 | | `list_environments` | Find environments | |
| 19 | | `get_connector` | Get the operation index for a connector | |
| 20 | | `get_operation_details` | Exact parameter names, types, enums, and required action type | |
| 21 | | `list_connections` | Verify connections exist | |
| 22 | | `invoke_operation` | Resolve dynamic dropdown/tree values | |
| 23 | | `get_expression_help` | Look up Logic Apps expression functions + examples | |
| 24 | | `validate_flow` | Pre-flight definition check (offline rules) | |
| 25 | | `preflight_flow` | Multi-signal readiness check (missing refs, solution-wrap) | |
| 26 | | `create_flow` | Create the flow | |
| 27 | | `edit_flow` | Apply surgical action-level edits when iterating | |
| 28 | | `get_flow` | Verify creation | |
| 29 | | `publish_flow` | Enable the flow | |
| 30 | | `scaffold_flow` | Generate from a built-in template | |
| 31 | |
| 32 | ## Critical Rules |
| 33 | |
| 34 | 1. **ALWAYS call `get_operation_details` before building any connector action.** Never guess parameter names, enum values, or action types. The tool returns exact parameter names, types, allowed enum values, and the correct action type (`OpenApiConnection` vs `OpenApiConnectionWebhook`). |
| 35 | |
| 36 | 2. **Use the correct action type.** Standard operations use `OpenApiConnection`. Webhook operations (Approvals `StartAndWaitForAnApproval`, etc.) use `OpenApiConnectionWebhook`. `get_operation_details` returns this in the `actionType` field. |
| 37 | |
| 38 | 3. **Always declare both parameters** in the definition: |
| 39 | ```json |
| 40 | "parameters": { |
| 41 | "$authentication": { "defaultValue": {}, "type": "SecureObject" }, |
| 42 | "$connections": { "defaultValue": {}, "type": "Object" } |
| 43 | } |
| 44 | ``` |
| 45 | |
| 46 | 4. **Do NOT include `authentication` in action inputs.** The Flow API auto-injects it on save. |
| 47 | |
| 48 | 5. **Use `Embedded` source** in connection references. Never `Invoker`. |
| 49 | |
| 50 | 6. **HTTP Request triggers (`kind: "Http"`) require Premium.** Use `kind: "Button"` for free/seeded plans. |
| 51 | |
| 52 | 7. **Validate before creating.** Call `validate_flow` to catch errors before hitting the API. |
| 53 | |
| 54 | ## Workflow |
| 55 | |
| 56 | 1. **Discover environment**: Call `list_environments`. Use `query` param to filter by name if the user specified one. |
| 57 | |
| 58 | 2. **Check for templates**: If the description matches a common pattern, call `list_templates` and `scaffold_flow` to start from a template instead of building from scratch. |
| 59 | |
| 60 | 3. **Look up connector operations**: For each connector the flow needs, call `get_connector` with a `query` to fi |
People who liked this also viewed
6 picksType
- paperclip-create-agentCreate new agents in Paperclip with governance-aware hiring. Use when you need to inspect adapter configuration options, compare existing agent configs, draft a new agent prompt/config, and submit a hSkillsJul 2026
- subagent-driven-developmentUse when executing implementation plans with independent tasks in the current sessionSkillsJul 2026
- dispatching-parallel-agentsUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesSkillsJul 2026
- browser-act-skill-forgeForges reusable Skill packages (SKILL.md + scripts) from website exploration via browser-act — no re-exploration later. Use when: user wants a reusable Skill for any website, needs to understand a sitSkillsJul 2026
- wizardGenerate an interactive bash wizard that walks a human through a manual procedure — third-party setup, a one-off migration, an A→B state transition — opening URLs, capturing values, confirming each stSkillsJul 2026
- wonda-cliUsing the Wonda CLI to generate images, videos, music, and audio from the terminal — plus LinkedIn, Reddit, and X/Twitter research and automationSkillsJul 2026
