Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Solution Design Skill for Microsoft Power Platform

Turn workshop notes into a client-ready Solution Design document (.docx) for any Microsoft Power Platform or Dynamics 365 project — in seconds, in Dutch, with your own branding.

Works as a Claude skill and a GitHub Copilot prompt file. Brand-neutral: you plug in your own company details. Ships with official Microsoft Learn and licensing sources so the generated design reflects how the platform actually works.

Language note: the generated document is written in Dutch (Nederlands). The skill instructions are bilingual; the output document is Dutch by design.


What it does

Given raw workshop notes or bullet points, the skill:

  1. Detects the platform — D365 Sales, Customer Service, Field Service, Customer Insights, Power Apps (model-driven / canvas), Power Automate, or Azure integration.
  2. Determines the licensing — picks the most cost-effective license for the customer's needs, cross-checked against the official Microsoft licensing guides.
  3. Proposes the document sections and confirms with you before writing.
  4. Asks all open questions in one batch — no back-and-forth.
  5. Generates a styled .docx — cover page, header/footer, entity tables, security matrix, ERD, assumptions, out-of-scope, and more.

Uncertain items are highlighted yellow and labelled [TE BEPALEN] so nothing false slips into a client document.


Repository layout

.
├── SKILL.md                              # Claude skill (YAML frontmatter + workflow)
├── .github/prompts/
│   └── solution-design.prompt.md         # GitHub Copilot prompt file (mode: agent)
├── LICENSE                               # MIT
├── CONTRIBUTING.md
└── README.md

Install — Claude

Claude Code

Clone into your skills directory (global or per-project):

# Global
git clone https://github.com/dvsry/power-platform-solution-design.git \
  ~/.claude/skills/solution-design

# or per-project
git clone https://github.com/dvsry/power-platform-solution-design.git \
  .claude/skills/solution-design

Claude Code discovers SKILL.md automatically. Invoke by asking, e.g. "schrijf een solution design op basis van deze notities", or /solution-design.

claude.ai

Download solution-design-skill.skill from the latest Release and upload it as a skill in your workspace.


Install — GitHub Copilot

Copilot uses prompt files (.prompt.md) in VS Code.

  1. Copy .github/prompts/solution-design.prompt.md into your repository's .github/prompts/ folder (already there if you clone this repo).
  2. Enable prompt files — VS Code setting chat.promptFiles = true.
  3. In Copilot Chat, run:
/solution-design

Paste your workshop notes when asked.


Configure your branding (one-time)

The skill contains no hard-coded company name. Set these once, or let the skill ask for them (missing values are flagged yellow as [TE BEPALEN]):

Placeholder Meaning Default
[Bedrijfsnaam] Vendor/partner producing the document fill in
[Bedrijfsadres] Footer address fill in
[Contactgegevens] Footer contact (email / phone) fill in
[Merkkleur] Heading hex colour #1F3864
[Classificatie] Document classification (header) Extern – Beperkt

Sources baked into the skill

The skill references official Microsoft documentation so generated content matches real platform behaviour:

Microsoft updates these links and guides periodically. The skill instructs the model to verify the current version before using them in a client document.


Contributing

Issues and PRs welcome — see CONTRIBUTING.md. Keep SKILL.md and .github/prompts/solution-design.prompt.md in sync when changing the workflow.

License

MIT — free to use, modify, and share.

About

Brand-neutral skill: turn workshop notes into a client-ready Solution Design (.docx) for Microsoft Power Platform / Dynamics 365. Works in Claude and GitHub Copilot.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors