GitHub Copilot Agents & Skills for Terraform on Azure

Template repository providing specialized GitHub Copilot agents and reusable skills for Terraform Azure operations. Enhance your infrastructure-as-code workflow with AI-powered assistance for security scanning, module discovery, and architecture validation.

Overview

This template provides ready-to-use components for Copilot-enhanced Terraform workflows:

• Specialized Agents - Pre-configured agents for module management, security analysis, and architecture review
• Reusable Skills - Modular capabilities following the Agent Skills specification
• MCP Integration - Configuration for HashiCorp Terraform and Azure MCP servers
• Best Practices - Guidelines aligned with Azure Well-Architected Framework and Cloud Adoption Framework

Important: This is a template repository, not infrastructure code. Copy these components into your Terraform projects.

Repository Structure

.github/
├── agents/                     # Specialized Copilot agents
│   ├── terraform-module-expert.agent.md
│   ├── terraform-security.agent.md
│   ├── terraform-coordinator.agent.md
│   ├── terraform-provider-upgrade.agent.md
│   └── azure-architecture-reviewer.agent.md
├── skills/                     # Reusable agent skills
│   ├── azure-verified-modules/
│   ├── terraform-security-scan/
│   ├── terraform-provider-upgrade/
│   ├── azure-architecture-review/
│   └── github-actions-terraform/
└── copilot-instructions.md     # Global Copilot configuration
.vscode/
└── mcp.json                    # MCP server configuration
AGENTS.md                       # AI agent context documentation

Agents

Pre-configured agents for specialized Terraform operations (.github/agents/):

Skills

Modular capabilities following Agent Skills specification (.github/skills/):

Prerequisites

To use the agents and skills in this template:

• Azure MCP Server extension
• Docker (for HashiCorp Terraform MCP Server)
• Azure CLI (az login required)

MCP configuration is included in .vscode/mcp.json.

Quick Start

Use as GitHub Template:

gh repo create my-terraform-azure --template YOUR_USERNAME/github-copilot-skills-terraform

Copy to Existing Repository:

cp -r .github/agents your-terraform-repo/.github/
cp -r .github/skills your-terraform-repo/.github/
cp .github/copilot-instructions.md your-terraform-repo/.github/
cp .vscode/mcp.json your-terraform-repo/.vscode/
cp AGENTS.md your-terraform-repo/

Documentation

• Copilot Instructions - Global configuration
• AGENTS.md - AI agent context and guidelines
• Agent Definitions - Individual agent documentation
• Skills Directory - Skill specifications and references

Resources

• Agent Skills Specification
• GitHub Awesome Copilot
• VS Code Copilot Customization
• About Agent Skills

Contributing

Contributions are welcome. To contribute:

1. Fork this repository
2. Create a feature branch
3. Add your agent (.github/agents/) or skill (.github/skills/)
4. Submit a pull request with clear description

Follow the .agent.md format for agents and include SKILL.md for skills.

License

MIT License - See LICENSE for details.