analyze-pp-solution

Analyzes exported Power Platform solutions against 10 SIG maintainability guidelines and generates a rated findings report.

10|2|Updated Jun 3, 2026
One-click install
npx skills add https://github.com/AgniusBartninkas/maintainable-flows --skill analyze-pp-solution-agniusbartninkas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: analyze-pp-solution
Source: https://github.com/AgniusBartninkas/maintainable-flows/tree/main/skills/analyze-pp-solution
Command: npx skills add https://github.com/AgniusBartninkas/maintainable-flows --skill analyze-pp-solution-agniusbartninkas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Power Platform solutions often grow into hard-to-maintain collections of canvas apps, cloud flows, and desktop flows with no objective quality assessment. This Skill automates a maintainability audit of an exported solution zip, mapping findings to the 10 SIG guidelines from the "Building Maintainable Software" book translated to Power Platform. ## Core Features & Use Cases - Automated Solution Analysis: Extracts the solution zip with PowerShell Expand-Archive and inspects solution.xml, customizations.xml, canvas app .fx.yaml files, and cloud flow JSON definitions. - 10-Guideline Audit: Evaluates unit length, complexity, duplication, interfaces, modularity, coupling, balance, codebase size, test automation, and clean code practices across canvas apps, cloud flows, and desktop flows. - Structured Report: Produces a markdown report with per-guideline ratings (green/yellow/red), findings, positive signals, and actionable recommendations. - Use Case: A consultant receives a client's exported solution zip and needs an objective maintainability assessment before a refactoring engagement; the Skill unpacks it, audits all components, and delivers a rated report. ## Quick Start Analyze the attached Power Platform solution zip file for maintainability issues and generate the full 10-guideline report.

Frequently Asked Questions about analyze-pp-solution

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze a Power Platform solution for maintainability?

Provide the exported solution zip file and solution name to the Skill. It extracts the archive with PowerShell Expand-Archive, inspects all component definitions, and generates a markdown report rating each of the 10 SIG maintainability guidelines.

What files are checked in a Power Platform solution analysis?

The analysis reads solution.xml, customizations.xml, canvas app .fx.yaml files, cloud flow JSON definitions in Workflows/, Dataverse business rules, connection references, environment variable definitions, and desktop flow binaries.

Can the analysis detect desktop flow logic in a solution?

Yes. Desktop flow definitions are parsed from customizations.xml, where Robin code is stored per flow. The desktop flow binary files only contain dependency and UI element metadata, not the actual logic.

What are the 10 SIG maintainability guidelines for Power Platform?

They cover short units of code, simple units, no duplication, small interfaces, separated concerns, loose coupling, balanced components, small codebase, automated tests, and clean code, each translated to Power Platform-specific checks.

What happens if I do not provide a solution name?

The Skill treats the missing solution name as a blocker and explicitly requests it before proceeding, since the name is required for naming conventions checks and the output report filename.

Does the analysis modify or deploy the solution?

No. The analysis is strictly read-only. It performs no deployments, configuration changes, or modifications, and does not infer business intent beyond what is present in the solution metadata.