Agent Skills

What This Demonstrates

This repo ships 2 agent skills under .github/skills/. Agent skills are folders of instructions and scripts that Copilot loads on demand — here, 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.”