create-flow

Guided Flow Creation Wizard

Walk the user through creating a Power Automate flow step by step.

Tools

This skill uses the FlowAgent MCP tools. Clients surface them with a

client-specific prefix — mcp__flowagent__<tool> (Claude Code) or

flowagent-<tool> (Copilot CLI) — so they're referred to by bare name below

(e.g. create_flow). Use CLI shell commands (local engine build only) for

CLI-only operations (connection lifecycle, sharing, solutions/admin) or when no

MCP tools are present.

Steps

1. Gather requirements: Ask what the flow should do. Identify triggers, actions, connectors.

1. Select environment: Call list_environments (use query to filter). Let user pick or auto-select.

1. Check for templates: Call list_templates. If a template matches (approval, digest, webhook, etc.), offer to use scaffold_flow as a starting point.

1. Discover connectors: For each connector, call get_connector with query to find the operation, then get_operation_details for exact parameters. Never guess parameter names or types.

1. Verify connections: Call list_connections filtered by each connector. Confirm Connected status.

1. Resolve dynamic values: For params with dynamicValues/dynamicTree annotations, call invoke_operation to get actual values (Teams channels, SharePoint sites, etc.).

1. Review with user: Present the flow design. Use AskUserQuestion to confirm trigger, actions, and connections before creating.

1. Generate definition: Build following all rules:

• Always declare $authentication (SecureObject) and $connections (Object) parameters
• Use correct action type: OpenApiConnection or OpenApiConnectionWebhook (from get_operation_details)
• Do NOT include authentication in action inputs
• Use Embedded source in connection references
• HTTP Request triggers require Premium; prefer Button kind

1. Validate: Call validate_flow (and optionally preflight_flow) to pre-check. For expressions, look up syntax with get_expression_help.

1. Create: Call create_flow in Stopped state. Report ID and name.

1. Optionally publish: Ask if user wants to enable. If yes, call publish_flow. For later one-off tweaks, use edit_flow (surgical) rather than resending the whole definition.