Add GitHub Copilot Agent Skill for Foundry Agent integration

[Copilot]

Implements a GitHub Copilot Agent Skill that enables Copilot to invoke Microsoft Foundry Agent endpoints for advanced AI capabilities.

Implementation

Skill Definition (.github/skills/foundry-agent/SKILL.md)

• YAML frontmatter with skill metadata following GitHub Copilot Agent Skills spec
• Embedded implementation examples in Python, TypeScript, and C#
• Error handling patterns for HTTP, timeout, connection, and auth failures

Client Examples (examples/)

• Python implementation using requests with full error handling and CLI
• TypeScript implementation using axios with type safety
• Both support environment-based configuration and conversation context

Configuration

• FOUNDRY_AGENT_ENDPOINT: Foundry Agent URL
• FOUNDRY_AGENT_API_KEY: Optional authentication
• VS Code setting: chat.useAgentSkills: true

Usage Pattern

# Python client example
client = FoundryAgentClient()
result = client.ask("Analyze the latest trends")

# Request payload
{
  "message": "user prompt",
  "conversation_id": "optional-uuid"
}

The skill automatically activates when Copilot detects user prompts requiring advanced AI processing beyond standard capabilities.

Files

• .github/skills/foundry-agent/SKILL.md - Skill definition (222 lines)
• examples/python_example.py - Python implementation (157 lines)
• examples/typescript_example.ts - TypeScript implementation (180 lines)
• examples/{requirements.txt,package.json} - Dependencies
• README.md, ARCHITECTURE.md, examples/README.md - Documentation
• .gitignore - Standard exclusions

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• your-foundry-endpoint.azure.com
  • Triggering command: /usr/bin/python3 python3 examples/python_example.py (dns block)
  • Triggering command: /usr/bin/python3 python3 ./examples/python_example.py Test the Foundry Agent integration (dns block)
  • Triggering command: /usr/bin/python3 python3 ./examples/python_example.py (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

Github copilot skill example that calls foundry agent application.

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.