🆕 NEW: GitHub Copilot SDK Skill

Just added! A comprehensive skill for building agentic applications with the GitHub Copilot SDK — GitHub's new programmable layer for embedding Copilot's agentic workflows into any application.

🔗 View the Copilot SDK Skill →

What you'll learn:

Install and configure the SDK in TypeScript, Python, Go, and .NET
Create custom tools that Copilot can invoke during reasoning
Implement streaming responses for real-time output
Manage sessions and persist conversations
Handle errors gracefully with proper cleanup

👤 Author

Yuval Avidani

AI Builder & Speaker | GitHub Star ⭐ | AWS GenAI Superstar 🌟

Building the future with AI agents, automation, and cutting-edge technology.
20+ years turning complex ideas into production-ready solutions.

🎤 Speaker & Enterprise AI Trainer
🏆 Recognized for open-source contributions

🤖 This repository was created by Yuval Avidani using GitHub Copilot via VS Code Insiders — demonstrating the power of AI-assisted development!

✨ What Are Agent Skills?

Agent skills are specialized knowledge modules that enhance AI coding agents with domain-specific expertise. They provide:

🎯 Focused Knowledge — Only what the AI doesn't already know
📝 Production-Ready Code — Working examples, not abstract concepts
⚡ Quick Activation — Trigger keywords for instant context
🔄 Reusable Patterns — Copy once, use everywhere

�️ Understanding Agent Skills (Open Standard)

What is SKILL.md?

SKILL.md is a simple, open format for giving AI agents new capabilities and expertise. It's an open standard that works across multiple AI coding agents and platforms.

Agent Skills are folders of instructions, scripts, and resources that your AI agent can discover and use to perform tasks more accurately and efficiently.

Why Use Agent Skills?

For You (Developer):

📚 Learn Faster — Pre-built knowledge from experts in your domain
🎯 Better Results — Agents have context to work more accurately
♻️ Reuse Everywhere — Same skill works across Copilot, Claude Code, Cursor, Windsurf, and more
🔐 Version Control — Skills are part of your repository, tracked in git

For Your Team:

📖 Capture Knowledge — Document processes and best practices
🚀 Share Skills — Distribute expertise across projects
🏢 Enterprise Use — Centralize organizational knowledge

For AI Agents:

🧠 Domain Expertise — Perform specialized tasks reliably
🔧 New Capabilities — Enable new workflows and automations
🎓 Context — Access procedures, scripts, and examples on demand

What Can You Do With Agent Skills?

Agent skills enable AI agents to:

Domain Expertise: Package specialized knowledge (legal review, data analysis, deployment procedures)
New Capabilities: Create presentations, build MCP servers, analyze datasets, debug failures
Repeatable Workflows: Turn multi-step tasks into consistent, auditable processes
Interoperability: Reuse skills across different compatible agent products

📚 How Agent Skills Work (Step-by-Step for Beginners)

Step 1: Understanding the File Structure

Each skill is a simple folder with a SKILL.md file inside:

your-project/
├── .github/skills/          # GitHub Copilot project skills location
│   └── my-skill-name/
│       ├── SKILL.md         # Main skill file (required)
│       ├── script.js        # Optional: supporting scripts
│       └── examples.md      # Optional: more examples
├── .claude/skills/          # Claude Code project skills location
│   └── my-skill-name/
│       └── SKILL.md
└── ~/.copilot/skills/       # Personal skills (available across all projects)
    └── my-skill-name/
        └── SKILL.md

Step 2: Understanding SKILL.md Format

Every SKILL.md file has two parts:

YAML Frontmatter (metadata):

---
name: my-skill-name           # Unique identifier (lowercase, hyphens for spaces)
description: What this skill  # When should the agent use this skill?
license: MIT                  # Optional: license information
---

Markdown Body (instructions): The rest of the file contains instructions and examples for the AI agent.

Step 3: A Real Example

Here's what a simple SKILL.md looks like:

---
name: github-actions-debugging
description: Guide for debugging failing GitHub Actions workflows. Use this when asked to debug CI/CD failures or workflow issues.
---

# Debugging GitHub Actions Workflows

When debugging a failing workflow:

1. **Check the job logs** - Look for error messages and stack traces
2. **Review recent changes** - What changed since the last successful run?
3. **Test locally** - Reproduce the issue in your local environment
4. **Fix and validate** - Make changes and verify they work

## Common Issues and Solutions

### Issue: Workflow fails with "Command not found"
**Solution**: Install the required tool in your workflow step

### Issue: Permission denied when running scripts
**Solution**: Add `chmod +x script.sh` before running the script

Step 4: Agent Discovers and Uses Your Skill

When you ask your AI agent to do something:

"Debug why our GitHub Actions workflow is failing"

The agent will:

✅ Recognize that you're asking about GitHub Actions
✅ Find the github-actions-debugging skill in your project
✅ Load the SKILL.md file into its context
✅ Follow the instructions to help you debug

Step 5: Supported Locations

Project Skills (specific to one repository):

your-repo/.github/skills/ — For GitHub Copilot
your-repo/.claude/skills/ — For Claude Code

Personal Skills (available across all projects on your machine):

~/.copilot/skills/ — For GitHub Copilot (Copilot CLI and VS Code)
~/.claude/skills/ — For Claude Code

Organization/Enterprise Skills (coming soon):

Enterprise-level skills support is in development

🤝 Supported AI Agents

Agent Skills work with these AI coding agents:

| Agent | Support | Location | |:------|:--------|:---------| | GitHub Copilot | ✅ Full Support | .github/skills/ or ~/.copilot/skills/ | | Claude Code | ✅ Full Support | .claude/skills/ or ~/.claude/skills/ | | Cursor | ✅ Full Support | .cursor/rules/ | | Windsurf | ✅ Full Support | .windsurf/rules/ | | VS Code Insiders | ✅ Full Support | Agent mode with skills | | VS Code (Stable) | ⏳ Coming Soon | Support coming in future release |

📦 Available Skills

| Skill | Description | Keywords | |:------|:------------|:---------| | copilot-sdk 🆕 | GitHub Copilot SDK for building agentic applications | Copilot SDK, GitHub SDK, agentic app, embed Copilot | | aws-agentcore | AWS Bedrock AgentCore development patterns | AgentCore, Bedrock Agent, AWS agent | | aws-strands | Model-agnostic agent framework with Strands SDK | Strands, ReAct agent, model-agnostic | | aws-account-management | AWS Organizations, IAM, billing & multi-account | AWS Organizations, IAM, SCPs, Cost Explorer | | langchain | LangChain/LangGraph pipelines and agent workflows | LangChain, LangGraph, RAG, LCEL | | vercel | Vercel deployment, serverless, and edge functions | Vercel, serverless, edge function | | railway | Railway platform deployment and configuration | Railway, deploy container | | cloudflare | Cloudflare Workers, Pages, D1, R2, KV & AI | Cloudflare, Workers, D1, R2, edge computing | | figma | Figma API, component code generation & design tokens | Figma API, design tokens, Figma to code | | fal-ai | Serverless AI image/video generation with fal.ai | fal.ai, Flux, SDXL, AI image generation | | **[mongodb](

ai-agents-skills

💡 Summary

🎯 Target Audience