📦
Skills
2993 + modular AI skills for Claude Code, Cursor, Windsurf, Copilot & Gemini CLI — the largest open-source AI skills library.
0 installs
1.6K stars
150 forks
Trust: 92 — Excellent
Devtools
Installation
npx skillsAsk AI about Skills
Powered by Claude · Grounded in docs
I know everything about Skills. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
Agent Skills
[!NOTE] Work in Progress — This repository is under active development. More skills are being added, existing skills are being updated to use the latest SDK patterns, and tests are being expanded to ensure quality. Contributions welcome!
Skills, custom agents, AGENTS.md templates, and MCP configurations for AI coding agents working with Azure SDKs and Microsoft AI Foundry.
Blog post: Context-Driven Development: Agent Skills for Microsoft Foundry and Azure
🔍 Skill Explorer: Browse all 174 skills with 1-click install
Quick Start
npx skills add microsoft/skills
Select the skills you need from the wizard. Skills are installed to your chosen agent's directory (e.g., .github/skills/ for GitHub Copilot) and symlinked if you use multiple agents.
Alternative installation methods
Manual installation (git clone)
# Clone and copy specific skills
git clone https://github.com/microsoft/skills.git
cp -r agent-skills/.github/skills/azure-cosmos-db-py your-project/.github/skills/
# Or use symlinks for multi-project setups
ln -s /path/to/agent-skills/.github/skills/mcp-builder /path/to/your-project/.github/skills/mcp-builder
# Share skills across different agent configs in the same repo
ln -s ../.github/skills .opencode/skills
ln -s ../.github/skills .claude/skills
Coding agents like Copilot CLI and GitHub Copilot in VS Code are powerful, but they lack domain knowledge about your SDKs. The patterns are already in their weights from pretraining. All you need is the right activation context to surface them.
[!IMPORTANT] Use skills selectively. Loading all skills causes context rot: diluted attention, wasted tokens, conflated patterns. Only copy skills essential for your current project.
What's Inside
| Resource | Description |
|---|---|
| 174 Skills | Domain-specific knowledge for Azure SDK and Foundry development |
| Plugins | Installable plugin packages (deep-wiki, azure-skills and more) |
| Custom Agents | Role-specific agents (backend, frontend, infrastructure, planner) |
| AGENTS.md | Template for configuring agent behavior in your projects |
| MCP Configs | Pre-configured servers for docs, GitHub, browser automation |
| Documentation | Repo docs and usage guides |
Skill Catalog
174 skills across language plugins — see skill catalog below for the full breakdown
| Language | Count | Suffix |
|---|---|---|
| Core | 10 | — |
| Foundry (Language-Agnostic) | 11 | — |
| Python | 39 | -py |
| .NET | 28 | -dotnet |
| TypeScript | 25 | -ts |
| Java | 25 | -java |
| Rust | 7 | -rust |
Core
10 skills — tooling, infrastructure, language-agnostic
| Skill | Description |
|---|---|
| cloud-solution-architect | Design well-architected Azure cloud systems. Architecture styles, 44 design patterns, technology choices, mission-critical design, WAF pillars. |
| copilot-sdk | Build applications powered by GitHub Copilot using the Copilot SDK. Session management, custom tools, streaming, hooks, MCP servers, BYOK, deployment patterns. |
| entra-agent-id | Microsoft Entra Agent ID (preview) — create OAuth2-capable AI agent identities via Microsoft Graph beta API. Blueprints, BlueprintPrincipals, permissions, WIF. |
| frontend-design-review | Review and create distinctive frontend interfaces. Design system compliance, quality pillars, accessibility, and creative aesthetics. |
| github-issue-creator | Convert raw notes, error logs, or screenshots into structured GitHub issues. |
| github-primer-brand | Design GitHub-branded marketing surfaces with @primer/react-brand. Color, typography, layout, components, theming, motion, voice, and anti-patterns for landing pages, launch sites, and campaign surfaces. |
| mcp-builder | Build MCP servers for LLM tool integration. Python (FastMCP), Node/TypeScript, or C#/.NET. |
| podcast-generation | Generate podcast-style audio with Azure OpenAI Realtime API. Full-stack React + FastAPI + WebSocket. |
| skill-creator | Guide for creating effective skills for AI coding agents. |
Foundry (Language-Agnostic)
11 skills — Microsoft Foundry agent platform (preview), language-agnostic via
azd,azCLI, and Foundry MCP
| Skill | Description |
|---|---|
| microsoft-foundry | Router skill for the Foundry agent platform — maps user intent onto the right sub-skill and discovery surface (Microsoft Docs MCP, Foundry MCP, azd ai agent, az CLI). |
| foundry-projects-resources | Provision Foundry resources/projects, configure project connections (key, OAuth, managed identity, agent identity), and set up standard or private-network agent infrastructure. |
| foundry-models | Discover, deploy, and manage models on Foundry — preset/customized deployments, capacity discovery, quota management, PTU vs pay-as-you-go. |
| foundry-hosted-agents | Build, deploy, and manage Foundry hosted agents — containerized agents exposing Responses or Invocations protocols, with per-agent Entra identity and dedicated endpoints. |
| foundry-toolboxes | Curate intent-based Foundry Toolboxes (preview) — a single MCP-compatible endpoint bundling tools (MCP, Web Search, AI Search, Code Interpreter, File Search, OpenAPI, A2A) for any agent to consume. |
| foundry-workflows | Build multi-agent workflows — declarative orchestration for handing off control between specialist agents, plus the Connected Agents pattern. |
| foundry-iq-knowledge-bases | Build Foundry IQ knowledge bases (preview) — multi-source, permission-aware grounding for agents using the agentic retrieval pipeline. |
| foundry-managed-skills | Manage SKILL.md files as a Foundry-side resource (preview) — author behavioral guidelines once, store via the Skills REST API, load into hosted agent containers. |
| foundry-memory | Build personalized Foundry agents with managed long-term memory (preview) — extract, consolidate, and retrieve user-specific context across sessions. |
| foundry-observability | Trace, monitor, and evaluate Foundry hosted agents end-to-end — OpenTelemetry GenAI traces in App Insights, eval-trace correlation, batch evals, regression detection. |
| foundry-governance | Govern Foundry agent fleets at scale — tool catalog visibility, AI Gateway MCP routing/policy, RBAC, agent identity, RAI policies on model deployments. |
Python
39 skills • suffix:
-py
Foundry & AI (5 skills)
| Skill | Description |
|---|---|
| agent-framework-azure-ai-py | Agent Framework SDK — persistent agents, hosted tools, MCP servers, streaming. |
| azure-ai-contentsafety-py | Content Safety SDK — detect harmful content in text/images with multi-severity classification. |
| azure-ai-contentunderstanding-py | Content Understanding SDK — multimodal extraction from documents, images, audio, video. |
| azure-ai-projects-py | High-level Foundry SDK — project client, versioned agents, evals, connections, OpenAI-compatible clients. |
| azure-search-documents-py | AI Search SDK — vector search, hybrid search, semantic ranking, indexing, skillsets. |
M365 (1 skill)
| Skill | Description |
|---|---|
| m365-agents-py | Microsoft 365 Agents SDK — aiohttp hosting, AgentApplication routing, streaming, Copilot Studio client. |
AI Services (8 skills)
| Skill | Description |
|---|---|
| azure-ai-ml-py | ML SDK v2 — workspaces, jobs, models, datasets, compute, pipelines. |
| azure-ai-textanalytics-py | Text Analytics — sentiment, entities, key phrases, PII detection, healthcare NLP. |
| azure-ai-transcription-py | Transcription SDK — real-time and batch speech-to-text with timestamps, diarization. |
| azure-ai-translation-document-py | Document Translation — batch translate Word, PDF, Excel with format preservation. |
| azure-ai-translation-text-py | Text Translation — real-time translation, transliteration, language detection. |
| azure-ai-vision-imageanalysis-py | Vision SDK — captions, tags, objects, OCR, people detection, smart cropping. |
| azure-ai-voicelive-py | Voice Live SDK — real-time bidirectional voice AI with WebSocket, VAD, avatars. |
| azure-speech-to-text-rest-py | Speech to Text REST API — transcribe short audio (≤60 seconds) via HTTP without Speech SDK. |
Data & Storage (7 skills)
| Skill | Description |
|---|---|
| azure-cosmos-db-py | Cosmos DB patterns — FastAPI service layer, dual auth, partition strategies, TDD. |
| azure-cosmos-py | Cosmos DB SDK — document CRUD, queries, containers, globally distributed data. |
| azure-data-tables-py | Tables SDK — NoSQL key-value storage, entity CRUD, batch operations. |
| azure-storage-blob-py | Blob Storage — upload, download, list, containers, lifecycle management. |
| azure-storage-file-datalake-py | Data Lake Gen2 — hierarchical file systems, big data analytics. |
| azure-storage-file-share-py | File Share — SMB file shares, directories, cloud file operations. |
| azure-storage-queue-py | Queue Storage — reliable message queuing, task distribution. |
Messaging & Events (4 skills)
| Skill | Description |
|---|---|
| azure-eventgrid-py | Event Grid — publish events, CloudEvents, event-driven architectures. |
| azure-eventhub-py | Event Hubs — high-throughput streaming, producers, consumers, checkpointing. |
| azure-messaging-webpubsubservice-py | Web PubSub — real-time messaging, WebSocket connections, pub/sub. |
| azure-servicebus-py | Service Bus — queues, topics, subscriptions, enterprise messaging. |
Entra (2 skills)
| Skill | Description |
|---|---|
| azure-identity-py | Identity SDK — DefaultAzureCredential, managed identity, service principals. |
| azure-keyvault-py | Key Vault — secrets, keys, and certificates management. |
Monitoring (4 skills)
| Skill | Description |
|---|---|
| azure-monitor-ingestion-py | Monitor Ingestion — send custom logs via Logs Ingestion API. |
| azure-monitor-opentelemetry-exporter-py | OpenTelemetry Exporter — low-level export to Application Insights. |
| azure-monitor-opentelemetry-py | OpenTelemetry Distro — one-line App Insights setup with auto-instrumentation. |
| azure-monitor-query-py | Monitor Query — query Log Analytics workspaces and Azure metrics. |
Integration & Management (5 skills)
| Skill | Description |
|---|---|
| azure-appconfiguration-py | App Configuration — centralized config, feature flags, dynamic settings. |
| azure-containerregistry-py | Container Registry — manage container images, artifacts, repositories. |
| azure-mgmt-apicenter-py | API Center — API inventory, metadata, governance. |
| azure-mgmt-apimanagement-py | API Management — APIM services, APIs, products, policies. |
| azure-mgmt-botservice-py | Bot Service — create and manage Azure Bot resources. |
Patterns & Frameworks (3 skills)
| Skill | Description |
|---|---|
| azure-mgmt-fabric-py | Fabric Management — Microsoft Fabric capacities and resources. |
| fastapi-router-py | FastAPI routers — CRUD operations, auth dependencies, response models. |
| pydantic-models-py | Pydantic patterns — Base, Create, Update, Response, InDB model variants. |
.NET
29 skills • suffix:
-dotnet
Foundry & AI (6 skills)
| Skill | Description |
|---|---|
| azure-ai-document-intelligence-dotnet | Document Intelligence — extract text, tables from invoices, receipts, IDs, forms. |
| azure-ai-openai-dotnet | Azure OpenAI — chat, embeddings, image generation, audio, assistants. |
| azure-ai-projects-dotnet | AI Projects SDK — Foundry project client, agents, connections, evals. |
| azure-ai-voicelive-dotnet | Voice Live — real-time voice AI with bidirectional WebSocket. |
| azure-mgmt-weightsandbiases-dotnet | Weights & Biases — ML experiment tracking via Azure Marketplace. |
| azure-search-documents-dotnet | AI Search — full-text, vector, semantic, hybrid search. |
M365 (1 skill)
| Skill | Description |
|---|---|
| m365-agents-dotnet | Microsoft 365 Agents SDK — ASP.NET Core hosting, AgentApplication routing, Copilot Studio client. |
Data & Storage (6 skills)
| Skill | Description |
|---|---|
| azure-mgmt-fabric-dotnet | Fabric ARM — provision, scale, suspend/resume Fabric capacities. |
| azure-resource-manager-cosmosdb-dotnet | Cosmos DB ARM — create accounts, databases, containers, RBAC. |
| azure-resource-manager-mysql-dotnet | MySQL Flexible Server — servers, databases, firewall, HA. |
| azure-resource-manager-postgresql-dotnet | PostgreSQL Flexible Server — servers, databases, firewall, HA. |
| azure-resource-manager-redis-dotnet | Redis ARM — cache instances, firewall, geo-replication. |
| azure-resource-manager-sql-dotnet | SQL ARM — servers, databases, elastic pools, failover groups. |
Messaging (3 skills)
| Skill | Description |
|---|---|
| azure-eventgrid-dotnet | Event Grid — publish events, CloudEvents, EventGridEvents. |
| azure-eventhub-dotnet | Event Hubs — high-throughput streaming, producers, processors. |
| azure-servicebus-dotnet | Service Bus — queues, topics, sessions, dead letter handling. |
Entra (3 skills)
| Skill | Description |
|---|---|
| azure-identity-dotnet | Identity SDK — DefaultAzureCredential, managed identity, service principals. |
| azure-security-keyvault-keys-dotnet | Key Vault Keys — key creation, rotation, encrypt/decrypt, sign/verify. |
| microsoft-azure-webjobs-extensions-authentication-events-dotnet | Entra Auth Events — custom claims, token enrichment, attribute collection. |
Compute & Integration (6 skills)
| Skill | Description |
|---|---|
| azure-maps-search-dotnet | Azure Maps — geocoding, routing, map tiles, weather. |
| azure-mgmt-apicenter-dotnet | API Center — API inventory, governance, versioning, discovery. |
| azure-mgmt-apimanagement-dotnet | API Management ARM — APIM services, APIs, products, policies. |
| azure-mgmt-botservice-dotnet | Bot Service ARM — bot resources, channels (Teams, DirectLine). |
| azure-resource-manager-durabletask-dotnet | Durable Task ARM — schedulers, task hubs, retention policies. |
| azure-resource-manager-playwright-dotnet | Playwright Testing ARM — workspaces, quotas. |
Monitoring & Partner (3 skills)
| Skill | Description |
|---|---|
| azure-mgmt-applicationinsights-dotnet | Application Insights — components, web tests, workbooks. |
| azure-mgmt-arizeaiobservabilityeval-dotnet | Arize AI — ML observability via Azure Marketplace. |
| azure-mgmt-mongodbatlas-dotnet | MongoDB Atlas — manage Atlas orgs as Azure ARM resources. |
TypeScript
25 skills • suffix:
-ts
Foundry & AI (6 skills)
| Skill | Description |
|---|---|
| azure-ai-contentsafety-ts | Content Safety — moderate text/images, detect harmful content. |
| azure-ai-document-intelligence-ts | Document Intelligence — extract from invoices, receipts, IDs, forms. |
| azure-ai-projects-ts | AI Projects SDK — Foundry client, agents, connections, evals. |
| azure-ai-translation-ts | Translation — text translation, transliteration, document batch. |
| azure-ai-voicelive-ts | Voice Live — real-time voice AI with WebSocket, Node.js or browser. |
| azure-search-documents-ts | AI Search — vector/hybrid search, semantic ranking, knowledge bases. |
M365 (1 skill)
| Skill | Description |
|---|---|
| m365-agents-ts | Microsoft 365 Agents SDK — AgentApplication routing, Express hosting, streaming, Copilot Studio client. |
Data & Storage (5 skills)
| Skill | Description |
|---|---|
| azure-cosmos-ts | Cosmos DB — document CRUD, queries, bulk operations. |
| azure-postgres-ts | PostgreSQL — connect to Azure Database for PostgreSQL with pg, pooling, Entra ID auth. |
| azure-storage-blob-ts | Blob Storage — upload, download, list, SAS tokens, streaming. |
| azure-storage-file-share-ts | File Share — SMB shares, directories, file operations. |
| azure-storage-queue-ts | Queue Storage — send, receive, peek, visibility timeout. |
Messaging (3 skills)
| Skill | Description |
|---|---|
| azure-eventhub-ts | Event Hubs — high-throughput streaming, partitioned consumers. |
| azure-servicebus-ts | Service Bus — queues, topics, sessions, dead-letter handling. |
| azure-web-pubsub-ts | Web PubSub — WebSocket real-time features, group chat, notifications. |
Entra & Integration (4 skills)
| Skill | Description |
|---|---|
| azure-appconfiguration-ts | App Configuration — settings, feature flags, Key Vault references. |
| azure-identity-ts | Identity SDK — DefaultAzureCredential, managed identity, browser login. |
| azure-keyvault-keys-ts | Key Vault Keys — create, encrypt/decrypt, sign, rotate keys. |
| azure-keyvault-secrets-ts | Key Vault Secrets — store and retrieve application secrets. |
Monitoring & Frontend (5 skills)
| Skill | Description |
|---|---|
| azure-microsoft-playwright-testing-ts | Playwright Testing — scale browser tests, CI/CD integration. |
| azure-monitor-opentelemetry-ts | OpenTelemetry — tracing, metrics, logs with Application Insights. |
| frontend-ui-dark-ts | Frontend UI Dark — Vite + React + Tailwind + Framer Motion dark-themed UI design system. |
| react-flow-node-ts | React Flow nodes — custom nodes with TypeScript, handles, Zustand. |
| zustand-store-ts | Zustand stores — TypeScript, subscribeWithSelector, state/action separation. |
Infrastructure & Orchestration (1 skill)
| Skill | Description |
|---|---|
| aspire-ts | .NET Aspire orchestration — AddViteApp, AddNodeApp, AddJavaScriptApp, service discovery, telemetry, deployment. |
Java
26 skills • suffix:
-java
Foundry & AI (7 skills)
| Skill | Description |
|---|---|
| azure-ai-anomalydetector-java | Anomaly Detector — univariate/multivariate time-series analysis. |
| azure-ai-contentsafety-java | Content Safety — text/image analysis, blocklist management. |
| azure-ai-formrecognizer-java | Form Recognizer — extract text, tables, key-value pairs from documents. |
| azure-ai-projects-java | AI Projects — Foundry project management, connections, datasets. |
| azure-ai-vision-imageanalysis-java | Vision SDK — captions, OCR, object detection, tagging. |
| azure-ai-voicelive-java | Voice Live — real-time voice conversations with WebSocket. |
Communication (5 skills)
| Skill | Description |
|---|---|
| azure-communication-callautomation-java | Call Automation — IVR, call routing, recording, DTMF, TTS. |
| azure-communication-callingserver-java | CallingServer (legacy) — deprecated, use callautomation for new projects. |
| azure-communication-chat-java | Chat SDK — threads, messaging, participants, read receipts. |
| azure-communication-common-java | Common utilities — token credentials, user identifiers. |
| azure-communication-sms-java | SMS SDK — notifications, alerts, OTP delivery, bulk messaging. |
Data & Storage (3 skills)
| Skill | Description |
|---|---|
| azure-cosmos-java | Cosmos DB — NoSQL operations, global distribution, reactive patterns. |
| azure-data-tables-java | Tables SDK — Table Storage or Cosmos DB Table API. |
| azure-storage-blob-java | Blob Storage — upload, download, containers, streaming. |
Messaging (3 skills)
| Skill | Description |
|---|---|
| azure-eventgrid-java | Event Grid — publish events, pub/sub patterns. |
| azure-eventhub-java | Event Hubs — high-throughput streaming, event-driven architectures. |
| azure-messaging-webpubsub-java | Web PubSub — WebSocket messaging, live updates, chat. |
Entra (3 skills)
| Skill | Description |
|---|---|
| azure-identity-java | Identity SDK — DefaultAzureCredential, managed identity, service principals. |
| azure-security-keyvault-keys-java | Key Vault Keys — RSA/EC keys, encrypt/decrypt, sign/verify, HSM. |
| azure-security-keyvault-secrets-java | Key Vault Secrets — passwords, API keys, connection strings. |
Monitoring & Integration (5 skills)
| Skill | Description |
|---|---|
| azure-appconfiguration-java | App Configuration — settings, feature flags, snapshots. |
| azure-compute-batch-java | Batch SDK — large-scale parallel and HPC jobs. |
| azure-monitor-ingestion-java | Monitor Ingestion — custom logs via Data Collection Rules. |
| azure-monitor-opentelemetry-exporter-java | OpenTelemetry Exporter — traces, metrics, logs to Azure Monitor. (Deprecated) |
| azure-monitor-query-java | Monitor Query — Kusto queries, Log Analytics, metrics. (Deprecated) |
Rust
7 skills • suffix:
-rust
Entra (4 skills)
| Skill | Description |
|---|---|
| azure-identity-rust | Identity SDK — DeveloperToolsCredential, ManagedIdentityCredential, ClientSecretCredential. |
| azure-keyvault-certificates-rust | Key Vault Certificates — create, import, manage certificates. |
| azure-keyvault-keys-rust | Key Vault Keys — RSA/EC keys, encrypt/decrypt, sign/verify. |
| azure-keyvault-secrets-rust | Key Vault Secrets — passwords, API keys, connection strings. |
Data & Storage (2 skills)
| Skill | Description |
|---|---|
| azure-cosmos-rust | Cosmos DB SDK — document CRUD, queries, containers, partitions. |
| azure-storage-blob-rust | Blob Storage — upload, download, containers, streaming. |
Messaging (1 skill)
| Skill | Description |
|---|---|
| azure-eventhub-rust | Event Hubs — high-throughput streaming, producers, consumers, batching. |
Repository Structure
AGENTS.md # Agent configuration template
.github/
├── skills/ # Backward-compat symlinks to plugin skills
├── plugins/ # Language-based plugin bundles (azure-sdk-python, etc.)
│ └── azure-sdk-*/ # Each bundle has skills/, commands/, agents/
├── prompts/ # Reusable prompt templates
├── agents/ # Agent persona definitions
├── scripts/ # Automation scripts (doc scraping)
├── workflows/ # GitHub Actions (daily doc updates)
└── copilot-instructions.md
docs/ # Generated llms.txt files (daily workflow) - GitHub Pages hosted
├── llms.txt # Links + summaries
└── llms-full.txt # Full content
skills/ # Symlinks for backward compatibility
├── python/ # -> ../.github/skills/*-py
├── dotnet/ # -> ../.github/skills/*-dotnet
├── typescript/ # -> ../.github/skills/*-ts
├── java/ # -> ../.github/skills/*-java
└── rust/ # -> ../.github/skills/*-rust
.vscode/
└── mcp.json # MCP server configurations
Plugins
Plugins are installable packages containing curated sets of agents, commands, and skills. Install via the Copilot CLI:
# Inside Copilot CLI, run these slash commands:
/plugin marketplace add microsoft/skills
/plugin install deep-wiki@skills
/plugin install azure-skills@skills
| Plugin | Description | Commands |
|---|---|---|
| deep-wiki | AI-powered wiki generator with Mermaid diagrams, source citations, onboarding guides, AGENTS.md, and llms.txt | /deep-wiki:generate, /deep-wiki:crisp, /deep-wiki:catalogue, /deep-wiki:page, /deep-wiki:research, /deep-wiki:ask, /deep-wiki:onboard, /deep-wiki:agents, /deep-wiki:llms, /deep-wiki:changelog, /deep-wiki:ado, /deep-wiki:build, /deep-wiki:deploy |
| azure-skills | Microsoft Azure MCP integration for cloud resource management, deployments, and Azure services. Includes 35 skills covering AI, storage, diagnostics, cost optimization, compliance, RBAC, the 3-step deployment workflow (azure-prepare → azure-validate → azure-deploy), and the language-agnostic microsoft-foundry orchestrator + 10 Foundry sub-skills (hosted agents, toolboxes, IQ knowledge bases, memory, observability, governance, more). | Skills-based (no slash commands) — auto-triggered by intent matching via azure and foundry-mcp MCP servers |
MCP Servers
Reference configurations in .vscode/mcp.json:
| Category | Servers |
|---|---|
| Documentation | microsoft-docs, context7, deepwiki |
| Development | github, playwright, terraform, eslint |
| Utilities | sequentialthinking, memory, markitdown |
For full MCP server implementations for Azure services, see microsoft/mcp.
Additional Resources
Agents
Role-specific agent personas in .github/agents/:
| Agent | Expertise |
|---|---|
backend.agent.md | FastAPI, Pydantic, Cosmos DB, Azure services |
frontend.agent.md | React, TypeScript, React Flow, Zustand, Tailwind |
infrastructure.agent.md | Bicep, Azure CLI, Container Apps, networking |
planner.agent.md | Task decomposition, architecture decisions |
presenter.agent.md | Documentation, demos, technical writing |
Use AGENTS.md as a template for configuring agent behavior in your own projects.
Prompts
Reusable prompt templates in .github/prompts/:
| Prompt | Purpose |
|---|---|
code-review.prompt.md | Structured code review with security, performance, and maintainability checks |
create-store.prompt.md | Zustand store creation with TypeScript and subscribeWithSelector |
create-node.prompt.md | React Flow custom node creation with handles and Zustand integration |
add-endpoint.prompt.md | FastAPI endpoint creation with Pydantic models and proper typing |
Documentation
See the docs at https://microsoft.github.io/skills/#documentation.
Testing Skills
The test harness validates that skills produce correct code patterns using the GitHub Copilot SDK. It evaluates generated code against acceptance criteria defined for each skill.
# Install test dependencies (from tests directory)
cd tests
pnpm install
# List skills with test coverage
pnpm harness --list
# Run tests for a specific skill (mock mode for CI)
pnpm harness azure-ai-projects-py --mock --verbose
# Run with Ralph Loop (iterative improvement)
pnpm harness azure-ai-projects-py --ralph --mock --max-iterations 5 --threshold 85
# Run unit tests
pnpm test
Test Coverage Summary
128 skills with 1158 test scenarios — all skills have acceptance criteria and test scenarios.
| Language | Skills | Scenarios | Top Skills by Scenarios |
|---|---|---|---|
| Core | 7 | 72 | copilot-sdk (11), podcast-generation (8), skill-creator (8) |
| Python | 41 | 331 | azure-ai-projects-py (12), pydantic-models-py (12), azure-ai-translation-text-py (11) |
| .NET | 29 | 290 | azure-resource-manager-sql-dotnet (14), azure-resource-manager-redis-dotnet (14), azure-servicebus-dotnet (13) |
| TypeScript | 25 | 270 | azure-storage-blob-ts (17), azure-servicebus-ts (14), aspire-ts (13) |
| Java | 26 | 195 | azure-storage-blob-java (12), azure-identity-java (12), azure-data-tables-java (11) |
Adding Test Coverage
See tests/README.md for instructions on adding acceptance criteria and scenarios for new skills.
Ralph Loop & Sensei Patterns
The test harness implements iterative quality improvement patterns inspired by Sensei:
Ralph Loop — An iterative code generation and improvement system that:
- Generate code for a given skill/scenario
- Evaluate against acceptance criteria (score 0-100)
- Analyze failures and build LLM-actionable feedback
- Re-generate with feedback until quality threshold is met
- Report on quality improvements across iterations
Sensei-style Scoring — Skills are evaluated on frontmatter compliance:
| Score | Requirements |
|---|---|
| Low | Basic description only |
| Medium | Description > 150 chars, has trigger keywords |
| Medium-High | Has "USE FOR:" triggers AND "DO NOT USE FOR:" anti-triggers |
| High | Triggers + anti-triggers + compatibility field |
Contributing
Adding New Skills
Note: The
azure-skillsplugin (.github/plugins/azure-skills/) is copied from microsoft/github-copilot-for-azure. Changes to that plugin should be made in the upstream repository rather than directly here.
New skills must follow the full workflow to ensure quality and discoverability:
Prerequisites:
- SDK package name (e.g.,
azure-ai-agents,Azure.AI.OpenAI) - Microsoft Learn documentation URL or GitHub repository
- Target language (py/dotnet/ts/java)
Workflow:
-
Create skill in
.github/skills/<skill-name>/SKILL.md- Naming:
azure-<service>-<language>(e.g.,azure-ai-projects-py) - Include YAML frontmatter with
nameanddescription - Reference official docs via
microsoft-docsMCP
- Naming:
-
Categorize with symlink in
skills/<language>/<category>/# Example: Python AI agent skill in foundry category cd skills/python/foundry ln -s ../../../.github/skills/azure-ai-projects-py projectsCategories:
foundry,data,messaging,monitoring,entra,integration,compute,m365,general -
Create acceptance criteria in
tests/scenarios/<skill>/acceptance-criteria.md- Document correct/incorrect import patterns
- Document authentication patterns
- Document async variants
-
Create test scenarios in
tests/scenarios/<skill>/scenarios.yaml- Test basic usage, error handling, advanced features
- Include mock responses for CI
-
Verify tests pass
cd tests && pnpm harness <skill-name> --mock --verbose -
Update README.md — Add to the appropriate language section in the Skill Catalog
Full guide: See
.github/skills/skill-creator/SKILL.md
Other Contributions
- Improve existing prompts and agents
- Share MCP server configurations
- Fix bugs in test harness
License
MIT