foundry-github-copilot-skill

This repository contains a GitHub Copilot Agent Skill that enables GitHub Copilot to call a Microsoft Foundry Agent application for advanced AI capabilities.

Overview

The Foundry Agent Skill enables GitHub Copilot to interact with Microsoft Foundry Agent applications for:

• Complex reasoning and analysis
• Advanced natural language understanding
• Specialized domain knowledge integration
• Custom AI workflows and processing
• Multi-step task orchestration

Installation

Step 1: Copy the Skill to Your Repository

Copy the .github/skills/foundry-agent/ folder to your target repository.

macOS/Linux:

# From your target repository
mkdir -p .github/skills
cp -r /path/to/foundry-github-copilot-skill/.github/skills/foundry-agent .github/skills/

Windows (PowerShell):

# From your target repository
New-Item -ItemType Directory -Force -Path .github\skills
Copy-Item -Recurse -Path C:\path\to\foundry-github-copilot-skill\.github\skills\foundry-agent -Destination .github\skills\

Or manually copy these files to your repository:

your-repo/
└── .github/
    └── skills/
        └── foundry-agent/
            ├── SKILL.md
            └── query_foundry_agent.py

Step 2: Install Python Dependencies

The skill requires Python 3.8+ and the following packages.

macOS:

# Install Python if needed (using Homebrew)
brew install python

# Install dependencies
pip3 install requests>=2.31.0 azure-identity>=1.15.0

Windows:

# Install Python from https://www.python.org/downloads/ or using winget
winget install Python.Python.3.11

# Install dependencies
pip install requests>=2.31.0 azure-identity>=1.15.0

Step 3: Install and Configure Azure CLI

macOS:

# Install Azure CLI using Homebrew
brew install azure-cli

# Sign in to Azure
az login

Windows:

# Install Azure CLI using winget
winget install Microsoft.AzureCLI

# Or download from: https://aka.ms/installazurecliwindows

# Sign in to Azure
az login

Step 4: Configure Azure Authentication

The skill uses Azure DefaultAzureCredential for secure, passwordless authentication.

az login

Step 5: Configure Your Foundry Agent Endpoint

Set the FOUNDRY_AGENT_APPLICATION_ENDPOINT environment variable to point to your Foundry Agent.

macOS/Linux:

export FOUNDRY_AGENT_APPLICATION_ENDPOINT="https://your-project.services.ai.azure.com/api/projects/your-project/applications/your-agent/protocols/openai/responses?api-version=2025-11-15-preview"

Windows (PowerShell):

$env:FOUNDRY_AGENT_APPLICATION_ENDPOINT = "https://your-project.services.ai.azure.com/api/projects/your-project/applications/your-agent/protocols/openai/responses?api-version=2025-11-15-preview"

Windows (Command Prompt):

set FOUNDRY_AGENT_APPLICATION_ENDPOINT=https://your-project.services.ai.azure.com/api/projects/your-project/applications/your-agent/protocols/openai/responses?api-version=2025-11-15-preview

Skill Structure

.github/skills/foundry-agent/
├── SKILL.md                    # Skill definition and metadata
└── query_foundry_agent.py      # Python implementation

Usage

Once installed and configured, the Foundry Agent skill is automatically available in GitHub Copilot.

Invoking the Skill

Invoke the skill by mentioning "Foundry" or "Foundry agent" in your Copilot prompts:

"Use the Foundry agent to analyze this code"
"Ask the Foundry agent what's new in Microsoft Foundry"
"Query the Foundry agent about cloud architecture best practices"
"Call the Foundry agent to explain this algorithm"

How It Works

1. You make a request in GitHub Copilot mentioning the Foundry agent
2. Copilot detects the intent and loads the foundry-agent skill
3. The skill authenticates using Azure DefaultAzureCredential
4. Sends your prompt to the configured Foundry Agent endpoint
5. Returns the response from the Foundry Agent back to you in Copilot

Resources

• Microsoft Foundry Documentation
• GitHub Copilot Agent Skills Documentation
• Foundry Agent Webapp Example