Update FlowStudio Power Automate skills#1664
Open
ninihen1 wants to merge 7 commits intogithub:stagedfrom
Open
Conversation
Foundation skill (flowstudio-power-automate-mcp) rewritten to use the server's new tool_search and list_skills meta-tools (v1.1.5+) for discovery instead of cataloging every tool by hand. Cut from 519 to 295 lines. New "Which Skill to Use When" intent-keyed decision tree points at the four specialized skills. Build/debug/governance/monitoring updated for use-case framing. Tools that genuinely cross tiers (e.g. debug skill borrowing get_store_flow_summary) are correct when the workflow needs them — the split between skills is by use-case intent, not by tool partition. Build skill: new Step 3a Resolving Dynamic Connector Values covers get_live_dynamic_options outer-parameter auto-bridge (v1.1.6+) and the AadGraph user-picker fallback via shared_office365users.SearchUserV2 (replaces broken builtInOperation:AadGraph.GetUsers). Debug skill: Outlook user-picker failure note pointing at the fallback. Monitoring skill description disambiguates from the server's monitor-flow tool bundle (runtime control of a single flow) — this skill is tenant-wide health analytics over the cached store. All 5 skills validate via npm run skill:validate; line endings LF only; codespell clean; auto-regenerated docs/README.skills.md included.
The v1.1.5 MCP server release marked 5 tools [DEPRECATED] but the previous alignment commit missed them. Replacements per server source: - get_live_flow_http_schema → read trigger.inputs.schema from get_live_flow - get_live_flow_trigger_url → read trigger.metadata.callbackUrl from get_live_flow - get_store_flow_trigger_url → get_store_flow.triggerUrl field - get_store_flow_errors → get_store_flow_runs(status=["Failed"]) - set_store_flow_state → set_live_flow_state Touches build, debug, governance, monitoring SKILL.md and the foundation skill's tool-reference.md. Remaining mentions of the deprecated names are intentional — they live in deprecation notices naming the obsolete wrapper alongside its replacement.
github-actions
Bot
added
the
skill-check-warning
Contributor
🔍 Skill Validator Results
Summary
Full validator output```text Found 5 skill(s) [flowstudio-power-automate-build] 📊 flowstudio-power-automate-build: 4,667 BPE tokens [chars/4: 4,925] (standard ~), 34 sections, 18 code blocks [flowstudio-power-automate-build] ⚠ Skill is 4,667 BPE tokens (chars/4 estimate: 4,925) — approaching "comprehensive" range where gains diminish. [flowstudio-power-automate-debug] 📊 flowstudio-power-automate-debug: 4,677 BPE tokens [chars/4: 4,671] (standard ~), 68 sections, 16 code blocks [flowstudio-power-automate-debug] ⚠ Skill is 4,677 BPE tokens (chars/4 estimate: 4,671) — approaching "comprehensive" range where gains diminish. [flowstudio-power-automate-governance] 📊 flowstudio-power-automate-governance: 3,350 BPE tokens [chars/4: 3,579] (standard ~), 17 sections, 11 code blocks [flowstudio-power-automate-governance] ⚠ Skill is 3,350 BPE tokens (chars/4 estimate: 3,579) — approaching "comprehensive" range where gains diminish. [flowstudio-power-automate-mcp] 📊 flowstudio-power-automate-mcp: 3,404 BPE tokens [chars/4: 3,373] (standard ~), 19 sections, 9 code blocks [flowstudio-power-automate-mcp] ⚠ Skill is 3,404 BPE tokens (chars/4 estimate: 3,373) — approaching "comprehensive" range where gains diminish. [flowstudio-power-automate-monitoring] 📊 flowstudio-power-automate-monitoring: 3,476 BPE tokens [chars/4: 3,282] (standard ~), 25 sections, 12 code blocks [flowstudio-power-automate-monitoring] ⚠ Skill is 3,476 BPE tokens (chars/4 estimate: 3,282) — approaching "comprehensive" range where gains diminish. ✅ All checks passed (5 skill(s)) ``` |
Contributor
There was a problem hiding this comment.
Pull request overview
Refreshes the FlowStudio Power Automate plugin’s skill documentation to match the latest canonical guidance, with updated tool-discovery patterns, new build/debug “gotchas”, and revised monitoring/governance workflows.
Changes:
- Updates the FlowStudio Power Automate skills content (foundation/mcp, build, debug, monitoring, governance) with new guidance and examples.
- Extends reference docs with new troubleshooting patterns and connector/build caveats (e.g., Copilot Studio Skills triggers, Office Scripts, SharePoint required fields).
- Updates the plugin README and the generated skills index entry in
docs/README.skills.md.
Reviewed changes
Copilot reviewed 15 out of 16 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| skills/flowstudio-power-automate-monitoring/SKILL.md | Refreshes monitoring guidance, tool usage, and Pro+ access behavior. |
| skills/flowstudio-power-automate-mcp/SKILL.md | Repositions as “foundation” skill; updates discovery/meta-tool guidance and oversized-response handling. |
| skills/flowstudio-power-automate-mcp/references/tool-reference.md | Adds guidance around solution migration and related semantics. |
| skills/flowstudio-power-automate-mcp/references/connection-references.md | Updates example placeholders for connection reference values. |
| skills/flowstudio-power-automate-governance/SKILL.md | Updates governance workflows (Pro+ gating, tool discovery, state management, ALM migration guidance). |
| skills/flowstudio-power-automate-debug/SKILL.md | Adds debug patterns and updates guidance for inspecting HTTP trigger schema via definition. |
| skills/flowstudio-power-automate-debug/references/debug-workflow.md | Extends workflow decision tree with additional failure modes. |
| skills/flowstudio-power-automate-debug/references/common-errors.md | Adds new “foreach parent failed” and null-filter cascade error patterns. |
| skills/flowstudio-power-automate-build/SKILL.md | Adds additional build/debug “gotchas” for Copilot Skills flows and connectors. |
| skills/flowstudio-power-automate-build/references/trigger-types.md | Adds Copilot Studio Skills trigger guidance and solution-migration note. |
| skills/flowstudio-power-automate-build/references/flow-schema.md | Adds notes about preserving/setting designer metadata IDs. |
| skills/flowstudio-power-automate-build/references/action-patterns-core.md | Adds agent retry loop pattern and risky expression assumptions table. |
| skills/flowstudio-power-automate-build/references/action-patterns-connectors.md | Adds SharePoint/Excel/Copilot Studio connector gotchas and parameter-shape notes. |
| plugins/flowstudio-power-automate/README.md | Reformats tables and updates skill descriptions to match new positioning. |
| plugins/flowstudio-power-automate/.github/plugin/plugin.json | Updates skill path entries in plugin manifest. |
| docs/README.skills.md | Updates the skills index descriptions for the FlowStudio Power Automate skills. |
Comments suppressed due to low confidence (1)
skills/flowstudio-power-automate-mcp/SKILL.md:294
- This bullet says tool parameters are in
tool_search, butreferences/tool-reference.mdstill instructs readers to usetools/listfor tool names/parameters. Please align these docs (either update tool-reference.md to point attool_search/list_skills, or change this line back totools/list) to avoid sending users to conflicting guidance.
- [MCP-BOOTSTRAP.md](references/MCP-BOOTSTRAP.md) — endpoint, auth, request/response format (read this first)
- [tool-reference.md](references/tool-reference.md) — response shapes and behavioral notes (parameters are in `tool_search`)
- [action-types.md](references/action-types.md) — Power Automate action type patterns
Comment on lines
+22
to
+26
| "./skills/flowstudio-power-automate-mcp", | ||
| "./skills/flowstudio-power-automate-debug", | ||
| "./skills/flowstudio-power-automate-build", | ||
| "./skills/flowstudio-power-automate-monitoring", | ||
| "./skills/flowstudio-power-automate-governance" |
Comment on lines
+206
to
+207
| Read the `triggerUrl` field directly from `get_store_flow` (cached) or | ||
| `get_live_flow` (live). It is `null` for non-HTTP triggers. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Updates the FlowStudio Power Automate skills and plugin package to the latest canonical skill content from
ninihen1/power-automate-mcp-skills.This refresh includes:
Validation
npm run skill:validatenpm run build