Add new agent skill: power-platform-architect#1395
Add new agent skill: power-platform-architect#1395TimHanewich wants to merge 2 commits intogithub:stagedfrom
Conversation
🔍 Skill Validator Results⛔ Findings need attention
Summary
Full validator output```text No skills found in the specified paths: "/home/runner/work/awesome-copilot/awesome-copilot/skills/power-platform-architect" ``` |
There was a problem hiding this comment.
Pull request overview
Adds a new Power Platform architecture “agent skill” intended to turn business requirements/transcripts into a Power Platform solution architecture (optionally with Mermaid diagrams), and registers it in the skills index.
Changes:
- Introduces a new
power-platform-architectskill content file plus an accompanying usage/demo README. - Adds the skill to
docs/README.skills.mdso it appears in the published skills list.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 5 comments.
| File | Description |
|---|---|
| skills/power-platform-architect/skill.md | New skill instructions and Power Platform component catalog (currently not in the required SKILL.md filename). |
| skills/power-platform-architect/readme.md | New human-facing documentation/demo content for the skill (uses lowercase filename). |
| docs/README.skills.md | Adds a row for the new skill, linking to SKILL.md. |
| - **Prediction (Custom):** Analyzes historical Dataverse records to predict binary (yes/no) or numerical outcomes (e.g., credit risk or project delays). | ||
| - **Dataverse:**- The primary data platform for the Power Platform ecosystem. Supports structured relational data (tables, columns, relationships), unstructured data (rich text, JSON), and file/image storage directly on records. Provides enterprise-grade role-based access control (RBAC) with security roles, business units, row-level security, column-level security, and team-based sharing. Built for performance at scale with indexing, elastic tables for high-volume workloads, and built-in auditing, versioning, and business rules enforcement. | ||
| - **Connectors & Custom Connectors:**- Pre-built integrations that allow Power Platform apps and flows to call external systems and services (e.g., SharePoint, SQL Server, Salesforce, SAP, ServiceNow). Over 1,500 standard connectors are available out of the box. Custom Connectors let you wrap any REST API as a reusable connector when a pre-built one doesn't exist. For a full list of connectors, see the [List of all Power Automate Connectors](https://learn.microsoft.com/en-us/connectors/connector-reference/connector-reference-powerautomate-connectors). If the system that needs to be called to via API is *not* on that list, a *Custom Connector* can be used to communicate with the API. | ||
| - **Power BI:**- The analytics and reporting engine of the Power Platform. Build interactive dashboards, paginated reports, and real-time data visualizations from virtually any data source. Key capabilities include: |
There was a problem hiding this comment.
Power BI ends with “Key capabilities include:” but no capabilities are listed, and Gateways immediately follows at the same list level. Either add a nested list of capabilities under Power BI or remove the trailing “Key capabilities include:” so the section reads complete.
| - **Power BI:**- The analytics and reporting engine of the Power Platform. Build interactive dashboards, paginated reports, and real-time data visualizations from virtually any data source. Key capabilities include: | |
| - **Power BI:**- The analytics and reporting engine of the Power Platform. Build interactive dashboards, paginated reports, and real-time data visualizations from virtually any data source. |
| | [power-bi-model-design-review](../skills/power-bi-model-design-review/SKILL.md) | Comprehensive Power BI data model design review prompt for evaluating model architecture, relationships, and optimization opportunities. | None | | ||
| | [power-bi-performance-troubleshooting](../skills/power-bi-performance-troubleshooting/SKILL.md) | Systematic Power BI performance troubleshooting prompt for identifying, diagnosing, and resolving performance issues in Power BI models, reports, and queries. | None | | ||
| | [power-bi-report-design-consultation](../skills/power-bi-report-design-consultation/SKILL.md) | Power BI report visualization design prompt for creating effective, user-friendly, and accessible reports with optimal chart selection and layout design. | None | | ||
| | [power-platform-architect](../skills/power-platform-architect/SKILL.md) | Use this skill when the user needs to transform business requirements, use case descriptions, or meeting transcripts into a technical Power Platform solution architecture, including component selection and Mermaid.js diagrams. | `readme.md`<br />`skill.md` | |
There was a problem hiding this comment.
This new entry links to ../skills/power-platform-architect/SKILL.md, but the added skill file is currently skills/power-platform-architect/skill.md. This link will be broken (and skill validation will fail) unless the skill file is renamed to SKILL.md and/or the table entry is updated to match.
| | [power-platform-architect](../skills/power-platform-architect/SKILL.md) | Use this skill when the user needs to transform business requirements, use case descriptions, or meeting transcripts into a technical Power Platform solution architecture, including component selection and Mermaid.js diagrams. | `readme.md`<br />`skill.md` | | |
| | [power-platform-architect](../skills/power-platform-architect/skill.md) | Use this skill when the user needs to transform business requirements, use case descriptions, or meeting transcripts into a technical Power Platform solution architecture, including component selection and Mermaid.js diagrams. | `readme.md`<br />`skill.md` | |
| # Power Platform Architect Agent Skill | ||
|  | ||
| An [**agent skill**](https://learn.microsoft.com/en-us/agent-framework/agents/skills?pivots=programming-language-csharp) for GitHub Copilot or Claude Code that acts as a **Senior Solution Architect for the Microsoft Power Platform**. Give it business requirements, use case descriptions, or even raw meeting transcripts, and it produces a tailored technical architecture, complete with component recommendations and an optional Mermaid.js diagram. |
There was a problem hiding this comment.
For consistency with other skills that include documentation (e.g., skills/azure-architecture-autopilot/README.md), consider renaming this file to README.md. On case-sensitive file systems, mixed casing can also be a source of confusion when referenced from generated docs.
| --- | ||
| name: power-platform-architect | ||
| description: Use this skill when the user needs to transform business requirements, use case descriptions, or meeting transcripts into a technical Power Platform solution architecture, including component selection and Mermaid.js diagrams. | ||
| license: MIT | ||
| metadata: | ||
| author: Tim Hanewich | ||
| --- |
There was a problem hiding this comment.
npm run skill:validate (and related tooling) expects each skill folder to contain a SKILL.md file at the root. This folder currently has skill.md, so the skill will fail validation and won’t be picked up by the build tooling. Rename skills/power-platform-architect/skill.md to skills/power-platform-architect/SKILL.md (and update any references accordingly).
| - **Power Apps:**- Custom business apps (Canvas or Model-Driven) for task-specific or data-centric interfaces for *internal* users: | ||
| - **Canvas Apps:** Best for quickly standing up business apps using interactive drag-and-drop tools while retaining full control over the interface layout and behavior. Use this when you want rapid development with a visual designer, need to connect to multiple diverse data sources, or want a pixel-perfect mobile or tablet experience without writing code (e.g., a frontline worker mobile app or a field inspection form). | ||
| - **Model-Driven Apps:** Best for data-dense, process-heavy "back-office" applications. These are automatically generated from your Dataverse schema. Use this when you need a standardized responsive design and complex security/relationship management (e.g., a CRM or Asset Management system). | ||
| - **Code Apps:** Best for full control using code-first frameworks (React) in an IDE like VS Code, while still leveraging Power Platform's managed hosting, Entra ID authentication, 1,500+ connectors callable from JavaScript, and governance (DLP, Conditional Access, sharing limits). Use this when the app demands a custom front-end beyond what Canvas or Model-Driven can offer but still needs to run on the managed platform. | ||
| - **Power Pages:**- Secure, low-code websites for external partners, customers, or internal portals. |
There was a problem hiding this comment.
The markdown list structure in the component catalog is inconsistent: Code Apps is currently nested under Model-Driven Apps, and several bullets have an extra - after the bold label (e.g., **Power Apps:**-). This renders oddly and can miscommunicate that Code Apps is a subtype of Model-Driven rather than a peer. Adjust indentation so Canvas/Model-Driven/Code Apps are siblings, and remove the stray hyphens after the bold labels.
aaronpowell
left a comment
aaronpowell
left a comment
There was a problem hiding this comment.
The README isn't supported with a skill, the content should be embedded in the SKILL.md (or references).
Hi @aaronpowell The skill.md is included and contains the full content required for the model, you can see it here: https://github.com/TimHanewich/awesome-copilot/blob/staged/skills/power-platform-architect/skill.md The readme.md is provided in addition to skill.md purely as external documentation (human-facing) to host a video demo and a high-level overview for anyone browsing the repo. It is not intended to be ingested by the agent. I kept them separate so the skill.md remains a clean, functional file for the model, while the README provides the visual context for the community. Let me know if the readme.md needs to be removed entirely. |
Pull Request Checklist
npm startand verified thatREADME.mdis up to date.stagedbranch for this pull request.Description
Adds a new skill (power-platform-architect) that acts as a Senior Solution Architect for the Microsoft Power Platform. Given business requirements, use case descriptions, or meeting transcripts, it produces a tailored technical architecture with component recommendations and an optional Mermaid.js diagram.
Covers the full Power Platform ecosystem: Power Apps (Canvas, Model-Driven, Code Apps), Power Pages, Copilot Studio, Power Automate, AI Builder, Dataverse, Power BI, Connectors, and Gateways.
How it works:
Type of Contribution
Additional Notes
I am a Microsoft FTE (Solution Engineer in the field). Alias = timh.
By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.