Agent skill

Architecture Design

by thomast1906 in thomast1906/github-copilot-agent-skills

Design Azure cloud architectures from requirements and generate High-Level Design (HLD) documentation with service selection, patterns, cost estimates, and WAF alignment.

No licenceAuto-check passedDevOps & Cloud

Install Architecture Design

skills CLI
$ npx skills add thomast1906/github-copilot-agent-skills --skill architecture-design -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install thomast1906/github-copilot-agent-skills architecture-design --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/thomast1906/github-copilot-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/architecture-design .claude/skills/architecture-design && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
architecture-design
GitHub stars
202
Token cost
~2.7k tokens
SKILL.md length
994 words
Files
2
Skills in repo
15
Repo updated
First seen
Licence
None found

At a glance

Design Azure cloud architectures from requirements and generate High-Level Design (HLD) documentation with service selection, patterns, cost estimates, and WAF alignment.

  • Works in 12 steps: Gather Requirements → Select Azure Services → Design Architecture → …
  • Tasks that involve Cloud architecture
  • SKILL.md covers When to Use, Design Process, High-Level Design Output Format and Example HLD Snippet, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Architecture Design is an agent skill from thomast1906/github-copilot-agent-skills. Design Azure cloud architectures from requirements and generate High-Level Design (HLD) documentation with service selection, patterns, cost estimates, and WAF alignment. Use this when asked to design or architect Azure solutions.

Its SKILL.md is about 2.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `references.md`).

It sits in DevOps & Cloud, covering Cloud architecture and Software architecture. It works with Microsoft Azure. The repository describes itself as: Repo containing my GitHub Copilot Agent & Skills - continually experimenting!

When your agent uses it

  • Tasks that involve Cloud architecture
  • Tasks that involve Software architecture

Example prompts

  • “/architecture-design”

Workflow steps

12 steps, taken from the step headings in SKILL.md.

  1. Gather Requirements
  2. Select Azure Services
  3. Design Architecture
  4. Apply Well-Architected Framework
  5. Create Naming Convention
  6. Estimate Costs
  7. Executive Summary
  8. Requirements Summary
  9. Architecture Overview
  10. Component Design
  11. Networking Design
  12. Security Design

What it can do on your machine

Read from SKILL.md and the folder at commit 554ac0b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Architecture Design loads about 2.7k tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 994 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~63
When it runs · the whole SKILL.md, loaded when a task matches
~2.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 994 words (~2,688 tokens).

“Design comprehensive Azure architectures and produce HLD documentation following Well-Architected Framework and Cloud Adoption Framework best practices.”

— opening of SKILL.md by thomast1906
name
architecture-design
metadata.author
Thomas Thornton
metadata.version
1.0.0
metadata.last-updated
2026-05-19

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in .github/skills/architecture-design of thomast1906/github-copilot-agent-skills.

  • SKILL.md
  • references.md

Open the folder on GitHubat commit 554ac0b

Compare with similar skills

Architecture Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Architecture Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Architecture Design this skillthomast1906/github-copilot-agent-skills202—~2.7kAutomated safety check: PassNone
Azure Diagramscmb211087/azure-diagrams-skill150—~4kAutomated safety check: NotesMIT
Azure Architecture AdvisorMicrosoftDocs/Agent-Skills777—~15kAutomated safety check: PassCC-BY-4.0
Azv Diagram Azure SyncAzure/AZVerify101—~3.7kAutomated safety check: PassMIT
Azv Diagram Azure Sync DeepAzure/AZVerify101—~3.9kAutomated safety check: PassMIT
Architect For Startupsaws/agent-toolkit-for-aws2.8k—~3.7kAutomated safety check: PassApache-2.0

Similar skills

  • Azure Diagrams

    cmb211087/azure-diagrams-skill

    Comprehensive technical diagramming toolkit for solutions architects, presales, and developers.

    150 GitHub stars~4k tokensUpdated 3 mo ago
    DevOps & CloudAuto-check: notes
  • Azure Architecture Advisor

    MicrosoftDocs/Agent-Skills

    Official

    Guides Azure solution design by category, from reference architectures and design patterns to technology choices and migrations, fetching current Microsoft Learn pages over the network.

    777 GitHub stars~15k tokensUpdated 4 days ago
    DevOps & CloudAuto-check passed
  • Official

    Compare a Draw.io Azure architecture diagram against a live Azure environment to detect drift.

    101 GitHub stars~3.7k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed
  • Official

    Deep-compare a Draw.io Azure architecture diagram against a live Azure environment — checks both resource existence AND every tracked configuration property (SKU, size, settings, etc.) against…

    101 GitHub stars~3.9k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed
  • Architect For Startups

    aws/agent-toolkit-for-aws

    Official

    Startup-tailored AWS architecture advice for non-agent workloads, adjusted to the company's stage (pre-revenue through Series B+), team size, runway, and credits.

    2.8k GitHub stars~3.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Apex Microsoft Docs

    jonathan-vella/apex

    ANALYSIS SKILL — Query official Microsoft documentation to understand concepts, find tutorials, and learn how services work.

    217 GitHub stars~966 tokensUpdated yesterday
    DevOps & CloudAuto-check passed

More from thomast1906/github-copilot-agent-skills

All 15 skills in this repo
  • Copilot Skill Creator

    thomast1906/github-copilot-agent-skills

    Guides creating, updating, reviewing and validating GitHub Copilot agent skills, from deciding whether a skill is the right tool to structuring bundled resources.

    202 GitHub stars~4.1k tokensUpdated 2 days ago
    Auto-check passed
  • Azure API Management Security Review

    thomast1906/github-copilot-agent-skills

    Audits an Azure API Management setup against the OWASP API Security Top 10 and Azure Security Benchmark, covering policies, network layout and identity.

    202 GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed
  • Azure APIM Policy Authoring

    thomast1906/github-copilot-agent-skills

    Generates Azure API Management policy XML for authentication, rate limiting, CORS, error handling and transformations, consulting Azure best-practice and documentation tools first.

    202 GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check passed
  • APIOps Deployment for Azure APIM

    thomast1906/github-copilot-agent-skills

    Supplies Bicep and Terraform templates, CI/CD pipeline patterns and phased promotion plans for deploying Azure API Management with APIOps workflows.

    202 GitHub stars~3.6k tokensUpdated 2 days ago
    Auto-check passed
  • Azure Draw.io MCP Diagrams

    thomast1906/github-copilot-agent-skills

    Creates and edits architecture diagrams through the Draw.io MCP tool, with guidance for rendering Azure icons correctly and laying out network diagrams.

    202 GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed
  • Azure Pricing Lookup

    thomast1906/github-copilot-agent-skills

    Looks up live Azure retail prices by SKU, service or region through the Azure MCP pricing tool, estimates template costs and compares regions, price types and savings plans.

    202 GitHub stars~4.9k tokensUpdated 2 days ago
    Auto-check passed

Works with

Questions about Architecture Design

What does Architecture Design do?

Design Azure cloud architectures from requirements and generate High-Level Design (HLD) documentation with service selection, patterns, cost estimates, and WAF alignment. Architecture Design is an agent skill from thomast1906/github-copilot-agent-skills. Design Azure cloud architectures from requirements and generate High-Level Design (HLD) documentation with service selection, patterns, cost estimates, and WAF alignment.

When should I use Architecture Design?

Architecture Design fits situations like: tasks that involve Cloud architecture; tasks that involve Software architecture.

How do I install Architecture Design in Claude Code?

Run `npx skills add thomast1906/github-copilot-agent-skills --skill architecture-design -a claude-code`. Or copy the skill folder (.github/skills/architecture-design in thomast1906/github-copilot-agent-skills) into .claude/skills/architecture-design in your project. Claude Code loads it when a task matches its description.

How do I install Architecture Design in Codex?

Run `npx skills add thomast1906/github-copilot-agent-skills --skill architecture-design -a codex`. Or copy the skill folder (.github/skills/architecture-design in thomast1906/github-copilot-agent-skills) into .agents/skills/architecture-design in your project. Codex loads it when a task matches its description.

Can I use Architecture Design in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add thomast1906/github-copilot-agent-skills --skill architecture-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/architecture-design, .gemini/skills/architecture-design, .github/skills/architecture-design and .opencode/skills/architecture-design in your project.

What does Architecture Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Architecture Design is instructions for the agent only.

Does Architecture Design access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Architecture Design safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Architecture Design use?

No licence was found for Architecture Design or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Architecture Design use?

About 2.7k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Architecture Design?

Skills that share tags, products or a category with Architecture Design: Azure Diagrams (cmb211087/azure-diagrams-skill, 150 stars), Azure Architecture Advisor (MicrosoftDocs/Agent-Skills, 777 stars), Azv Diagram Azure Sync (Azure/AZVerify, 101 stars) and Azv Diagram Azure Sync Deep (Azure/AZVerify, 101 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Architecture Design?

thomast1906 (a GitHub user) maintains it in thomast1906/github-copilot-agent-skills, which has 202 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 7, 2026.

Source: thomast1906/github-copilot-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.