Official agent skill

Route Environments

by microsoft in microsoft/power-platform-skills

Check Power Platform environment routing status and understand default environment resolution.

OfficialMITAuto-check: notesAI & LLM Engineering

Install Route Environments

skills CLI
$ npx skills add microsoft/power-platform-skills --skill route-environments -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install microsoft/power-platform-skills route-environments --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/microsoft/power-platform-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/power-automate/skills/route-environments .claude/skills/route-environments && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
route-environments
GitHub stars
972
Token cost
~754 tokens
SKILL.md length
230 words
Files
1
Skills in repo
87
Repo updated
First seen
Licence
MIT

At a glance

Check Power Platform environment routing status and understand default environment resolution.

  • Works in 2 steps: Check Current State → Determine Operation
  • The user asks about environment routing
  • SKILL.md covers Step 1: Check Current State, Step 2: Determine Operation, Guidance and Decision Tree, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Route Environments is an agent skill from microsoft/power-platform-skills, published by the product's own GitHub organization. Check Power Platform environment routing status and understand default environment resolution. Use when the user asks about environment routing, developer environments, or new maker landing. Routing is configured in the admin center, not here. NOT for listing flows or managing connections.

Its SKILL.md is about 750 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering. It works with Power Automate and Microsoft Copilot Studio. The repository describes itself as: A plugin marketplace for GitHub Copilot and other AI agents that provides Power Platform development plugins, including reusable skills, agents, and commands for building and… The licence is MIT.

When your agent uses it

  • The user asks about environment routing
  • Developer environments
  • New maker landing

Example prompts

  • “/route-environments”

Requirements

  • Pre-approved tools (allowed-tools): Bash, Read, Write, Glob, Grep, AskUserQuestion, mcp__flowagent__list_environments, mcp__flowagent__set_current_env, mcp__flowagent__get_current_env, mcp__flowagent__resolve_environment, mcp__flowagent__whoami, mcp__flowagent__doctor, mcp__flowagent__reconnect, mcp__flowagent__list_accounts, mcp__flowagent__switch_account

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Check Current State
  2. Determine Operation

What it can do on your machine

Read from SKILL.md and the folder at commit 0d044b8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Write
    • Glob
    • Grep
    • AskUserQuestion
    • mcp__flowagent__list_environments
    • mcp__flowagent__set_current_env
    • mcp__flowagent__get_current_env
    • mcp__flowagent__resolve_environment

    …and 5 more on the same allowed-tools line.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Route Environments loads about 754 tokens when it runs. Until then it costs about 77 tokens; SKILL.md has 230 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~77
When it runs · the whole SKILL.md, loaded when a task matches
~754

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Write, Glob, Grep, AskUserQuestion, mcp__flowagent__list_environments, mcp__flowagent__s

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from microsoft/power-platform-skills at commit 0d044b8, republished under its MIT licence (© microsoft). 230 words, ~754 tokens.

Download SKILL.mdSave it as .claude/skills/route-environments/SKILL.md (or your agent's skills folder).
name
route-environments
description
Check Power Platform environment routing status and understand default environment resolution. Use when the user asks about environment routing, developer environments, or new maker landing. Routing is configured in the admin center, not here. NOT for listing flows or managing connections.
allowed-tools
Bash, Read, Write, Glob, Grep, AskUserQuestion, mcp__flowagent__list_environments, mcp__flowagent__set_current_env, mcp__flowagent__get_current_env, mcp__flowagent__resolve_environment, mcp__flowagent__whoami, mcp__flowagent__doctor, mcp__flowagent__reconnect, mcp__flowagent__list_accounts, mcp__flowagent__switch_account
user-invocable
true
argument-hint
[check|explain]
model
opus

Environment Routing Manager

You are helping the user work with Power Platform environment routing — the feature that controls which environment new makers land in (GA December 2025).

Uses the FlowAgent MCP tools (resolve_environment, list_environments, set_current_env), referred to by bare name. In Claude Code they appear as mcp__flowagent__<tool>; in Copilot CLI as flowagent-<tool>.

Step 1: Check Current State

Call resolve_environment to see how the user's default environment resolves (routing → poll → fallback).

Step 2: Determine Operation

Check Routing Status

Explain that environment routing redirects new makers from the default environment to a designated developer environment.

Key facts:

  • Generally available since December 2025
  • Most tenants scope routing with specificGroups rather than tenant-wide
  • Common uses: steering new makers to developer environments, Copilot Studio isolation
List Environments

Call list_environments (use the query param to filter by name).

Show environment types and help the user identify:

  • Their default environment
  • Any developer/sandbox environments
  • Environment with Dataverse linked
Resolve Default Environment

Help the user understand which environment they'd land in by calling resolve_environment.

Guidance

  • Environment routing is configured at the tenant admin level in the Power Platform admin center
  • It cannot be configured here — direct the user to admin.powerplatform.microsoft.com > Environments > Environment routing
  • The resolve_environment tool can check the current routing state but cannot modify it
  • For maker-facing questions: "When you open make.powerautomate.com, environment routing determines which environment you see first"

Decision Tree

User asks about environment routing?
├── "What is it?" → Explain: redirects new makers from default to dev env
├── "Is it enabled?" → resolve_environment to check
├── "How do I enable it?" → Direct to PPAC admin center
├── "Which environment am I in?" → list_environments + resolve_environment
└── "What environments exist?" → list_environments with details

References

© microsoft, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/power-automate/skills/route-environments of microsoft/power-platform-skills.

Open the folder on GitHubat commit 0d044b8

Compare with similar skills

Route Environments next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Route Environments compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Route Environments this skillmicrosoft/power-platform-skills972—~754Automated safety check: NotesMIT
MCP Copilot Studio Server Generatorgithub/awesome-copilot40k1 repos~1.1kAutomated safety check: PassMIT
Power Platform MCP Connector Suitegithub/awesome-copilot40k1 repos~1.6kAutomated safety check: PassMIT
Erp Xppmicrosoft/Dataverse-skills242—~3.8kAutomated safety check: PassMIT
Dv Metadatamicrosoft/Dataverse-skills242—~5.4kAutomated safety check: NotesMIT
Dv Securitymicrosoft/Dataverse-skills242—~2.1kAutomated safety check: PassMIT

Similar skills

  • Official

    Generate a complete MCP server implementation optimized for Copilot Studio integration with proper schema constraints and streamable HTTP support

    40k GitHub starsUsed in 1 repo~1.1k tokens
    Agent WorkflowsAuto-check passed
  • Official

    Generate complete Power Platform custom connector with MCP integration for Copilot Studio - includes schema generation, troubleshooting, and validation

    40k GitHub starsUsed in 1 repo~1.6k tokens
    Agent WorkflowsAuto-check passed
  • Erp Xpp

    microsoft/Dataverse-skills

    Official

    X++ code development lifecycle for Finance and Operations — scaffold models, author classes, custom services/APIs, and data entities, install matching SDKs, compile deployable packages, deploy…

    242 GitHub stars~3.8k tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed
  • Dv Metadata

    microsoft/Dataverse-skills

    Official

    Dataverse schema authoring and inspection — tables, columns, relationships, forms, and views.

    242 GitHub stars~5.4k tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check: notes
  • Dv Security

    microsoft/Dataverse-skills

    Official

    Security-role assignment, user access, application users, business units, and admin self-elevation in Dataverse environments.

    242 GitHub stars~2.1k tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed
  • Microsoft Docs

    microsoft/ai-agents-for-beginners

    Official

    Query official Microsoft documentation to find concepts, tutorials, and code examples across Azure, .NET, Agent Framework, Aspire, VS Code, GitHub, and more.

    77k GitHub starsUsed in 3 repos~1.2k tokens
    AI & LLM EngineeringAuto-check passed

More from microsoft/power-platform-skills

All 87 skills in this repo
  • Manage Firewall

    microsoft/power-platform-skills

    Official

    Inspects and configures the web application firewall (WAF) in front of a Power Pages production site.

    972 GitHub stars~4.5k tokensUpdated today
    Auto-check: notes
  • Manage Headers

    microsoft/power-platform-skills

    Official

    Inspects and configures the security headers a Power Pages site sends to browsers — Content Security Policy, frame and clickjacking protection, cross-origin sharing, cookie behavior, and related…

    972 GitHub stars~3k tokensUpdated today
    Auto-check: notes
  • Scan Code

    microsoft/power-platform-skills

    Official

    Scans a Power Pages site project for security issues in source code and dependencies.

    972 GitHub stars~3.4k tokensUpdated today
    Auto-check: notes
  • Scan Site

    microsoft/power-platform-skills

    Official

    Runs a security scan on a deployed Power Pages site, fetches the latest scan report, and produces a plain-language summary.

    972 GitHub stars~3.2k tokensUpdated today
    Auto-check: notes
  • Setup Datamodel

    microsoft/power-platform-skills

    Official

    Creates Dataverse tables, columns, and relationships for a Power Pages site based on a data model proposal.

    972 GitHub stars~4k tokensUpdated today
    Auto-check: notes
  • Add Server Logic

    microsoft/power-platform-skills

    Official

    Creates, edits, and manages Power Pages Server Logic files — server-side JavaScript that runs securely on the Power Pages runtime.

    972 GitHub stars~18k tokensUpdated today
    Auto-check: notes

Questions about Route Environments

What does Route Environments do?

Check Power Platform environment routing status and understand default environment resolution. Route Environments is an agent skill from microsoft/power-platform-skills, published by the product's own GitHub organization. Check Power Platform environment routing status and understand default environment resolution.

When should I use Route Environments?

Route Environments fits situations like: the user asks about environment routing; developer environments; new maker landing.

How do I install Route Environments in Claude Code?

Run `npx skills add microsoft/power-platform-skills --skill route-environments -a claude-code`. Or copy the skill folder (plugins/power-automate/skills/route-environments in microsoft/power-platform-skills) into .claude/skills/route-environments in your project. Claude Code loads it when a task matches its description.

How do I install Route Environments in Codex?

Run `npx skills add microsoft/power-platform-skills --skill route-environments -a codex`. Or copy the skill folder (plugins/power-automate/skills/route-environments in microsoft/power-platform-skills) into .agents/skills/route-environments in your project. Codex loads it when a task matches its description.

Can I use Route Environments in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add microsoft/power-platform-skills --skill route-environments -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/route-environments, .gemini/skills/route-environments, .github/skills/route-environments and .opencode/skills/route-environments in your project.

What does Route Environments need to run?

SKILL.md names no scripts, command-line tools or credentials: Route Environments is instructions for the agent only. Its frontmatter pre-approves these tools: Bash, Read, Write, Glob, Grep, AskUserQuestion, mcp__flowagent__list_environments, mcp__flowagent__set_current_env, mcp__flowagent__get_current_env, mcp__flowagent__resolve_environment, mcp__flowagent__whoami, mcp__flowagent__doctor, mcp__flowagent__reconnect, mcp__flowagent__list_accounts, mcp__flowagent__switch_account.

Does Route Environments access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Route Environments safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Route Environments use?

Route Environments is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Route Environments use?

About 754 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Route Environments?

Skills that share tags, products or a category with Route Environments: MCP Copilot Studio Server Generator (github/awesome-copilot, 40k stars), Power Platform MCP Connector Suite (github/awesome-copilot, 40k stars), Erp Xpp (microsoft/Dataverse-skills, 242 stars) and Dv Metadata (microsoft/Dataverse-skills, 242 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Route Environments?

microsoft (a GitHub organization, an official publisher) maintains it in microsoft/power-platform-skills, which has 972 GitHub stars. The repository holds 87 skills in this directory. The repository was last updated on October 7, 2026.

Source: microsoft/power-platform-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.