Custom Skills

What This Demonstrates

This repo ships 2 custom skills under .github/skills/. Skills are specialized tools that Copilot can invoke to produce artifacts like diagrams and visualizations.

Excalidraw Diagram Generator

Skill location: .github/skills/excalidraw-diagram-generator/

Generates .excalidraw diagram files from natural language descriptions. Supports flowcharts, relationship diagrams, mind maps, and system architecture diagrams.

Prompt

Create an Excalidraw architecture diagram showing the Octo E-Shop
microservices: frontend, user-service, product-service, cart-service,
order-service, payment-service, and their communication paths (HTTP sync
+ Azure Service Bus async).

What to look for:

.excalidraw file output that opens in Excalidraw
Service boxes with labels matching actual service names
Two types of arrows: solid (HTTP sync) and dashed (async events)
Logical layout grouping related services

Follow-Up Prompts

“Add Azure infrastructure components (AKS, ACR, Key Vault) to the diagram.”
“Create a sequence diagram showing the checkout flow from cart to payment.”
“Generate a mind map of all the technologies used in this project.”

Azure Resource Visualizer

Skill location: .github/skills/azure-resource-visualizer/

Analyzes Azure resource groups and produces Mermaid architecture diagrams showing relationships between individual resources.

Prompt

Analyze the Azure resource group for this project and generate a Mermaid
architecture diagram showing all resources and their relationships.

What to look for:

All Azure resources represented (AKS, ACR, PostgreSQL, Redis, Key Vault, etc.)
Relationship arrows between dependent resources
Resource metadata (SKU, location) as labels

Follow-Up Prompts

“Compare resources across the dev and staging environments.”
“Highlight which resources would be affected by a VNet change.”
“Export the diagram as SVG for documentation.”