$ loading_
Scan, assess, and upgrade Power BI Gen1 dataflows into Gen2.1 copies.
The material indicates an open-source prompt/document-style skill with no built-in secrets or fixed remote endpoints declared, sourced from a Microsoft GitHub repository with reasonable community adoption, so overall risk is relatively low. Caution is still warranted because it guides CLI and REST API use for Fabric/Power BI admin and migration tasks, including workspace/tenant scans and snapshot generation, which introduces normal risks around account privileges, data enumeration, and egress to Microsoft services during actual use.
No dedicated API key or environment variable is declared, but the README explicitly references `az login` and token acquisition for Fabric and Power BI REST APIs. The relevant credentials are Azure/Microsoft account tokens, which are sensitive; if used in a high-privilege tenant context, they could enable enumeration or SaveAs operations, though this is a normal credential risk consistent with the stated functionality.
No fixed remote host is declared in metadata, but the description clearly states it uses `az rest`/`curl` against Power BI REST and Fabric REST APIs, potentially scanning workspaces or entire tenants, generating snapshots, and calling SaveAsNativeArtifact. The egress targets appear function-related and presumably Microsoft-owned services, with no clear unrelated or unknown endpoint red flags; however, workspace/dataflow metadata would be sent to cloud APIs in practice.
This is not purely static documentation: it guides use of CLI commands such as `az rest` and `curl`, and even recommends an update check at session start, so it carries the normal ability to trigger local command execution. There is no clear request for system privileges beyond its purpose and no obviously malicious commands, but local execution of external commands still warrants caution.
The description shows it can scan Gen1 dataflows across a workspace or an entire tenant, assess dependencies and risk signals, and output Markdown/JSON snapshots. That implies access to and processing of Fabric/Power BI metadata, and likely local report file writes. The access scope is broadly consistent with migration assessment, with no explicit sign of overreach, but 'entire tenant' scanning means visibility can become wide and should be constrained by least privilege.
The source is a Microsoft GitHub open-source repository, and the system has already flagged it as open-source and prompt-only, with about 420 stars as positive community-trust evidence. License and maintenance status are not explicit in the material, and the README's 'run update check first' reads more like operational guidance than a direct supply-chain red flag; based on the available facts, supply-chain risk is relatively low.
Copy the install command and let the AI configure it · recommended for beginners
Please install the "dataflows-save-as-authoring-cli" skill from askskill: 1. Download https://raw.githubusercontent.com/microsoft/skills-for-fabric/main/skills/dataflows-save-as-authoring-cli/SKILL.md 2. Save it as ~/.claude/skills/dataflows-save-as-authoring-cli/SKILL.md 3. Reload skills and tell me it's ready
Scan all Gen1 dataflows in the specified Power BI workspace, list their names, workspace, owners, and save-as candidates, and output a summary table.
Returns an inventory of Gen1 dataflows in the workspace and flags items suitable for save-as assessment.
Run a save-as readiness assessment for Gen1 dataflows in this tenant, check the seven risk signals, and generate a Save-As Readiness Snapshot with both markdown and JSON outputs.
Produces readiness decisions, detailed risk findings for each dataflow, and a snapshot report for review or scheduling.
Create a Gen2.1 copy of the target Gen1 dataflow using the SaveAsNativeArtifact API, then validate data integrity and detect any residual Gen1 references.
Returns the upgrade result, details of the new copy, validation findings, and any remaining dependencies that need follow-up.
Update Check — ONCE PER SESSION (mandatory) The first time this skill is used in a session, run the check-updates skill before proceeding.
- GitHub Copilot CLI / VS Code: invoke the
check-updatesskill.- Claude Code / Cowork / Cursor / Windsurf / Codex: compare local vs remote package.json version.
- Skip if the check was already performed earlier in this session.
CRITICAL NOTES
- To find the workspace details (including its ID) from workspace name: list all workspaces and, then, use JMESPath filtering
- To find the item details (including its ID) from workspace ID, item type, and item name: list all items of that type in that workspace and, then, use JMESPath filtering
A save-as companion for creating upgraded Gen2.1 copies from Power BI Gen1 dataflows using readiness assessment and guarded execution.
We currently cannot perform an in-place migration of your dataflow. We can use save-as to create an upgraded Gen2.1 copy while preserving the original Gen1 dataflow.
| Task | Reference | Notes |
|---|---|---|
| Finding Workspaces and Items in Fabric | COMMON-CLI.md § Finding Workspaces and Items | Mandatory — READ link first |
| Fabric Topology & Key Concepts | COMMON-CORE.md § Fabric Topology | |
| Environment URLs | COMMON-CORE.md § Environment URLs | |
| Authentication & Token Acquisition | COMMON-CORE.md § Authentication | Wrong audience = 401 |
| Core Control-Plane REST APIs | COMMON-CORE.md § Core REST APIs | Pagination, LRO polling, rate limits |
| Tool Selection Rationale | COMMON-CLI.md § Tool Selection | |
| Authentication Recipes | COMMON-CLI.md § Auth Recipes | az login flows and token acquisition |
Fabric Control-Plane API via az rest | COMMON-CLI.md § az rest | Always pass --resource |
| Gotchas & Troubleshooting (CLI) | COMMON-CLI.md § Gotchas | az rest audience, shell escaping |
| Quick Reference | COMMON-CLI.md § Quick Ref | Token audience / tool matrix |
| Dataflow Definition Structure | DATAFLOWS-AUTHORING-CORE.md § Definition | 3-part format for Gen2 CI/CD |
| Consumption Capability Matrix | DATAFLOWS-CONSUMPTION-CORE.md § Capabilities | Read-only discovery patterns |
| Upgrade CLI Quick Reference | upgrade-cli-quickref.md | All az rest one-liners for scanning & save-as |
| Risk Assessment Guide | risk-assessment-guide.md | Risk signal detection logic & API calls |
| Tool | Role | Install |
|---|---|---|
az CLI | Primary: Auth (az login), REST API calls (az rest) against both Fabric and Power BI APIs. | Pre-installed in most dev environments |
jq | Parse and filter JSON responses (dataflow lists, risk signal extraction). | Pre-installed or trivial |
base64 | Decode dataflow definitions for inspection. | Built into bash / [Convert]::ToBase64String() in PowerShell |
Agent check — verify before first operation:
az --version 2>/dev/null || echo "INSTALL: https://aka.ms/install-azure-cli" jq --version 2>/dev/null || echo "INSTALL: apt-get install jq OR brew install jq"
…
Create, update, and publish Microsoft Fabric Eventstream topologies via REST APIs.
Migrate HDInsight Spark, Hive, and Oozie workloads to Microsoft Fabric.
Search Microsoft Fabric items across workspaces and return locations and IDs.
Create, edit, deploy, and optimize Power BI semantic models and DAX.
Diagnose Spark failures, session issues, and performance bottlenecks in Microsoft Fabric.
Build end-to-end Bronze, Silver, and Gold lakehouse pipelines in Microsoft Fabric.
Author and manage Fabric Dataflows Gen2 with preview and refresh via CLI.
Monitor, inspect, and query Fabric Dataflows Gen2 through a read-only CLI.
Discover Power BI assets, run DAX, and generate executive HTML reports.
Integrate Power Automate cloud flows into Power Pages with generated metadata and code.
Ask natural-language questions about Power BI reports and get business answers.
Generate office files from prompts and review Word documents with AI comments.