Skip to content
Back to search

github-copilot-agent-skills

Repo containing my GitHub Copilot Agent & Skills - continually experimenting!

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/thomast1906--github-copilot-agent-skills/badge.svg)](/listings/thomast1906--github-copilot-agent-skills)

HTML

<a href="/listings/thomast1906--github-copilot-agent-skills"><img src="/api/listings/thomast1906--github-copilot-agent-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

Prerequisites

- VS Code or VS Code Insiders with [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) and GitHub Copilot Chat enabled. - For APM installs: [APM (Agent Package Manager)](https://github.com/microsoft/apm).

# macOS / Linux
curl -sSL https://aka.ms/apm-unix | sh

# Windows PowerShell
irm https://aka.ms/apm-windows | iex

---

Option 1 — skills CLI (browse or install individual skills)

Use the skills CLI when you want to browse the catalogue or install a single skill without pulling in a full bundle.

npx skills add thomast1906/github-copilot-agent-skills

---

Option 2 — APM (curated packages with declared dependencies)

APM installs skills, agents, and MCP server configuration together. The root package pulls in all curated bundles. Use APM when you want a reproducible, manifest-driven install.

**Install the full curated collection:**

apm install thomast1906/github-copilot-agent-skills

**Install an individual bundle:**

apm install thomast1906/github-copilot-agent-skills/packages/architect
apm install thomast1906/github-copilot-agent-skills/packages/terraform
apm install thomast1906/github-copilot-agent-skills/packages/diagramming
apm install thomast1906/github-copilot-agent-skills/packages/drawio-mcp-diagramming

APM deploys agents and MCP configuration to the selected target. By default, skills are placed in `.agents/skills/`. Use `--legacy-skill-paths` if you need per-client directories such as `.github/skills/`.

---

Option 3 — Clone the repository

Clone or fork the repository to access every skill, including work in progress, and to contribute changes.

git clone https://github.com/thomast1906/github-copilot-agent-skills.git

Open the folder in VS Code, ensure GitHub Copilot Chat is enabled, and start the MCP servers relevant to the skills you plan to use (see [MCP servers](#mcp-servers) below). Then invoke a skill explicitly:

Use the waf-assessment skill to review this architecture.

Or select an agent from the GitHub Copilot Chat agent picker.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 213 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # GitHub Copilot Agent Skills
  2. [![skills.sh](https://skills.sh/b/thomast1906/github-copilot-agent-skills)](https://www.skills.sh/thomast1906/github-copilot-agent-skills) Only added 28/07/2026 - stats will be low until engagement follows this :)
  3. A curated collection of reusable agent skills and GitHub Copilot Chat agents covering Azure architecture, API Management, Terraform, diagramming, GitHub Agentic Workflows, and skill authoring. Each skill encapsulates engineering guidance and structured workflows so you do not have to restate context in every chat session.
  4. Install the full curated collection with APM, pick an individual skill through the skills CLI, or clone the repository to explore everything including work in progress.
  5. ---
  6. ## Browse the skills
  7. The repository is indexed at **[skills.sh/thomast1906/github-copilot-agent-skills](https://www.skills.sh/thomast1906/github-copilot-agent-skills)**, where you can browse individual skills, view their descriptions, and see skills.sh-specific installation statistics. Note that the skills.sh counters reflect installs made through the skills.sh platform and CLI; they do not include APM installations, Git clones, or manual copies.
  8. For the full source, examples, scripts, history, and contribution process, this GitHub repository remains the canonical reference.
  9. ---
  10. ## Installation
  11. ### Prerequisites
  12. - VS Code or VS Code Insiders with [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) and GitHub Copilot Chat enabled.
  13. - For APM installs: [APM (Agent Package Manager)](https://github.com/microsoft/apm).
  14. ```bash
  15. # macOS / Linux
  16. curl -sSL https://aka.ms/apm-unix | sh
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 28 on GitHub
  17. # Windows PowerShell
  18. irm https://aka.ms/apm-windows | iex
  19. ```
  20. ---
  21. ### Option 1 — skills CLI (browse or install individual skills)
  22. Use the skills CLI when you want to browse the catalogue or install a single skill without pulling in a full bundle.
  23. ```bash
  24. npx skills add thomast1906/github-copilot-agent-skills
  25. ```
  26. ---
  27. ### Option 2 — APM (curated packages with declared dependencies)
  28. APM installs skills, agents, and MCP server configuration together. The root package pulls in all curated bundles. Use APM when you want a reproducible, manifest-driven install.
  29. **Install the full curated collection:**
  30. ```bash
  31. apm install thomast1906/github-copilot-agent-skills
  32. ```
  33. **Install an individual bundle:**
  34. ```bash
  35. apm install thomast1906/github-copilot-agent-skills/packages/architect
  36. apm install thomast1906/github-copilot-agent-skills/packages/terraform
  37. apm install thomast1906/github-copilot-agent-skills/packages/diagramming
  38. apm install thomast1906/github-copilot-agent-skills/packages/drawio-mcp-diagramming
  39. ```
  40. APM deploys agents and MCP configuration to the selected target. By default, skills are placed in `.agents/skills/`. Use `--legacy-skill-paths` if you need per-client directories such as `.github/skills/`.
  41. ---
  42. ### Option 3 — Clone the repository
  43. Clone or fork the repository to access every skill, including work in progress, and to contribute changes.
  44. ```bash
  45. git clone https://github.com/thomast1906/github-copilot-agent-skills.git
  46. ```
  47. Open the folder in VS Code, ensure GitHub Copilot Chat is enabled, and start the MCP servers relevant to the skills you plan to use (see [MCP servers](#mcp-servers) below). Then invoke a skill explicitly:
  48. ```
  49. Use the waf-assessment skill to review this architecture.
  50. ```
  51. Or select an agent from the GitHub Copilot Chat agent picker.
  52. ---
  53. ## Available skills
  54. Skills are grouped below by area. Stable skills are included in an APM bundle; work-in-progress skills are available by cloning the repository.
  55. ### Azure Architecture
  56. | Skill | Description | APM bundle |
  57. |---|---|---|
  58. | [`architecture-design`](.github/skills/architecture-design) | Designs Azure cloud architectures from requirements, produces HLD documentation, selects services, and aligns to WAF and CAF. | `packages/architect` |
  59. | [`waf-assessment`](.github/skills/waf-assessment) | Assesses an architecture against the five Azure Well-Architected Framework pillars and provides scored recommendations. | `packages/architect` |
  60. | [`azure-pricing`](.github/skills/azure-pricing) | Looks up live Azure retail pricing for any SKU or region, estimates template costs, and compares pricing types. | `packages/architect` |
  61. | [`cost-optimization`](.github/skills/cost-optimization) | Analyses Azure architectures for cost reduction opportunities and estimates savings and ROI. *(work in progress)* | — |
  62. ### Azure API Management
  63. | Skill | Description | APM bundle |
  64. |---|---|---|
  65. | [`azure-apim-architecture`](.github/skills/azure-apim-architecture) | Analyses APIM topology, networking, multi-environment strategy, and cost trade-offs. *(work in progress)* | — |
  66. | [`apim-policy-authoring`](.github/skills/apim-policy-authoring) | Generates production-ready APIM policy XML for authentication, rate limiting, CORS, error handling, and transformations. *(work in progress)* | — |
  67. | [`api-security-review`](.github/skills/api-security-review) | Reviews APIM configurations against OWASP API Security Top 10, VNet Internal mode, Private Link, and Azure Security Benchmark. *(work in progress)* | — |
  68. | [`apiops-deployment`](.github/skills/apiops-deployment) | Guides APIM infrastructure deployment with Bicep or Terraform and CI/CD promotion workflows. *(work in progress)* | — |
  69. ### Terraform and Infrastructure as Code
  70. | Skill | Description | APM bundle |
  71. |---|---|---|
  72. | [`terraform-module-creator`](.github/skills/terraform-module-creator) | Designs maintainable Terraform modules from real infrastructure requirements using Azure-focused patterns. | `packages/terraform` |
  73. | [`terraform-provider-upgrade`](.github/skills/terraform-provider-upgrade) | Guides safe Terraform provider upgrades: breaking-change detection, resource migration with `moved` blocks, and validation. | `packages/terraform` |
  74. ### Diagramming
  75. | Skill | Description | APM bundle |
  76. |---|---|---|
  77. | [`drawio-mcp-diagramming`](.github/skills/drawio-mcp-diagramming) | Creates and edits architecture diagrams via the Draw.io MCP server with Azure2 and AWS4 icon library support. | `packages/diagramming`, `packages/drawio-mcp-diagramming` |
  78. | [`azure-drawio-mcp-diagramming`](.github/skills/azure-drawio-mcp-diagramming) | Creates and edits Azure-focused Draw.io diagrams with reliable Azure icon rendering guidance. | `packages/diagramming` |
  79. | [`excalidraw-mcp-diagramming`](.github/skills/excalidraw-mcp-diagramming) | Creates and edits diagrams on a live Excalidraw canvas; exports to PNG, SVG, `.excalidraw`, or a shareable URL. | `packages/diagramming` |
  80. ### GitHub and Agentic Workflows
  81. | Skill | Description | APM bundle |
  82. |---|---|---|
  83. | [`gh-aw-operations`](.github/skills/gh-aw-operations) | Creates, compiles, debugs, and manages GitHub Agentic Workflows with proper frontmatter, MCP wiring, and safe outputs. | — |
  84. ### Skill and Package Authoring
  85. | Skill | Description | APM bundle |
  86. |---|---|---|
  87. | [`skill-creator`](.github/skills/skill-creator) | Creates, updates, reviews, and validates GitHub Copilot `SKILL.md` files. | — |
  88. | [`apm-package-author`](.github/skills/apm-package-author) | Creates and troubleshoots APM manifests for distributing skills, agents, and MCP server configuration. | — |
  89. ### Agents
  90. Select an agent from the GitHub Copilot Chat agent picker for a guided, role-specific workflow.
  91. | Agent | What it does | APM bundle |
  92. |---|---|---|
  93. | [`azure-architect`](.github/agents/azure-architect.agent.md) | Designs Azure architectures and produces HLD documents aligned to WAF and CAF. | `packages/architect` |
  94. | [`terraform-provider-upgrade`](.github/agents/terraform-provider-upgrade.agent.md) | Performs structured Terraform provider upgrades and compatibility validation. | `packages/terraform` |
  95. | [`gh-aw-builder`](.github/agents/gh-aw-builder.agent.md) | Creates markdown-based GitHub Agentic Workflows with frontmatter, MCP wiring, and safe outputs. | `packages/terraform` |
  96. | [`apim-policy-author`](.github/agents/apim-policy-author.agent.md) | Generates Azure API Management policy XML for authentication, rate limiting, CORS, and error handling. | Repository only |
  97. ---
  98. ## Recommended usage
  99. | Goal | Recommended approach |
  100. |---|---|
  101. | Browse or install a single skill | skills CLI: `npx skills add thomast1906/github-copilot-agent-skills` |
  102. | Reproducible install of a full bundle with MCP configuration | APM: `apm install thomast1906/github-copilot-agent-skills` |
  103. | Review source, examples, history, or contribution process | Clone this repository |
  104. ---
  105. ## MCP servers
  106. Some skills call MCP servers for live data or diagram editing. APM configures the MCP servers bundled in package manifests automatically. Direct clones can use the included [`.vscode/mcp.json`](.vscode/mcp.json).
  107. | MCP server | Used by | Setup |
  108. |---|---|---|
  109. | Azure MCP | `architecture-design`, `waf-assessment`, `azure-pricing`, `cost-optimization`, `terraform-module-creator` | Install the [Azure Tools](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-github-copilot) VS Code extension; the server registers automatically. |
  110. | Draw.io MCP | `drawio-mcp-diagramming`, `azure-drawio-mcp-diagramming` | Configured automatically by the relevant APM bundles or the included `.vscode/mcp.json`. |
  111. | Excalidraw MCP | `excalidraw-mcp-diagramming` | Configured automatically by `packages/diagramming` or the included `.vscode/mcp.json`. |
  112. | Terraform MCP | `terraform-provider-upgrade`, `terraform-module-creator` | Configured automatically by `packages/terraform` or the included `.vscode/mcp.json`. Requires Docker. HCP Terraform or Terraform Enterprise credentials are optional for public registry use. |
  113. ---
  114. ## Repository structure
  115. ```text
  116. .github/
  117. ├── agents/ # Selectable GitHub Copilot Chat agents
  118. ├── skills/ # Skill directories (stable and work in progress)
  119. ├── scripts/ # Repository validation scripts
  120. └── workflows/ # CI validation workflows
  121. packages/
  122. ├── architect/ # Azure architecture APM bundle
  123. ├── terraform/ # Terraform APM bundle
  124. ├── diagramming/ # Complete diagramming APM bundle
  125. └── drawio-mcp-diagramming/ # Standalone Draw.io APM bundle
  126. apm.yml # Root curated APM package manifest
  127. ```
  128. ---
  129. ## Creating or contributing a skill
  130. Each skill lives under `.github/skills/<skill-name>/` and requires a `SKILL.md` file that contains its purpose, trigger description, step-by-step workflow, and tool guidance. Supporting references belong in a `references/` subdirectory. Reusable helpers belong in `.github/scripts/`.
  131. To contribute a new skill or improve an existing one:
  132. 1. Fork the repository and create a branch.
  133. 2. Add or update the skill directory under `.github/skills/`.
  134. 3. Run the format validation script before opening a pull request:
  135. ```bash
  136. ./.github/scripts/validate-agent-skills.sh
  137. ```
  138. 4. Open a pull request — the [`validate-skills`](.github/workflows/validate-skills.yaml) GitHub Actions workflow runs the same check on every push and pull request touching `.github/skills/`.
  139. The [`skill-creator`](.github/skills/skill-creator) skill itself can assist you in drafting a new `SKILL.md`. The [`apm-package-author`](.github/skills/apm-package-author) skill can help you create or troubleshoot an `apm.yml` manifest if you want to package a skill for distribution.
  140. ---
  141. ## Licence
  142. This repository is licensed under the [MIT Licence](https://opensource.org/licenses/MIT).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.