azure-architecture

What it does

The skill provides expert guidance for designing Azure solutions using Azure Architecture. It helps agents locate relevant sections via a Category Index, read specific lines or linked files, and fetch remote documentation content to inform architectural decisions. It includes directions to suggest updating content if the metadata timestamp is older than 3 months and to install a Microsoft Docs fetch tool if unavailable.

How it works

• Use the Category Index to locate relevant sections (Reference Architectures, Solution Ideas, Design Patterns, Technology Choices, Architecture Styles, Best Practices, Anti-patterns, Example Workloads, Migration Guides).
• For categories with line ranges (e.g., L35-L120), read the specified lines using read_file with the given lines.
• For categories with file links (e.g., security.md), read the linked reference file using read_file on the linked file.
• If metadata.generated_at is more than 3 months old, suggest pulling the latest version from the repository.
• If mcp_microsoftdocs tools are unavailable, suggest installing them via the provided Installation Guide.
• Requires network access to fetch documentation content using mcp_microsoftdocs:microsoft_docs_fetch (preferred) or fetch_webpage (fallback).
• Returns Markdown documentation to inform architectural guidance.

When to use it

Use when designing Azure solutions and need guidance across reference architectures, solution ideas, design patterns, technology choices, architecture styles, best practices, anti-patterns, example workloads, and migration guides.

What it can touch

• Tools: mcp_microsoftdocs:microsoft_docs_fetch, fetch_webpage
• Reads: Markdown content from remote Azure Architecture documentation and linked files

Caveats

• Requires network access.
• Relies on external documentation sources; freshness depends on remote content.
• If metadata.generated_at is old, a user-facing prompt to update is suggested but not enforced.