awesome-copilot/docs

🎯 Agent Skills

Agent Skills are self-contained folders with instructions and bundled resources that enhance AI capabilities for specialized tasks. Based on the Agent Skills specification, each skill contains a SKILL.md file with detailed instructions that agents load on-demand.

Skills differ from other primitives by supporting bundled assets (scripts, code samples, reference data) that agents can utilize when performing specialized tasks.

How to Use Agent Skills

What's Included:

• Each skill is a folder containing a SKILL.md instruction file
• Skills may include helper scripts, code templates, or reference data
• Skills follow the Agent Skills specification for maximum compatibility

When to Use:

• Skills are ideal for complex, repeatable workflows that benefit from bundled resources
• Use skills when you need code templates, helper utilities, or reference data alongside instructions
• Skills provide progressive disclosure - loaded only when needed for specific tasks

Usage:

• Browse the skills table below to find relevant capabilities
• Copy the skill folder to your local skills directory
• Reference skills in your prompts or let the agent discover them automatically

Name	Description	Bundled Assets
agentic-eval	Patterns and techniques for evaluating and improving AI agent outputs. Use this skill when: - Implementing self-critique and reflection loops - Building evaluator-optimizer pipelines for quality-critical generation - Creating test-driven code refinement workflows - Designing rubric-based or LLM-as-judge evaluation systems - Adding iterative improvement to agent outputs (code, reports, analysis) - Measuring and improving agent response quality	None
appinsights-instrumentation	Instrument a webapp to send useful telemetry data to Azure App Insights	LICENSE.txt examples/appinsights.bicep references/ASPNETCORE.md references/AUTO.md references/NODEJS.md references/PYTHON.md scripts/appinsights.ps1
aspire	Aspire skill covering the Aspire CLI, AppHost orchestration, service discovery, integrations, MCP server, VS Code extension, Dev Containers, GitHub Codespaces, templates, dashboard, and deployment. Use when the user asks to create, run, debug, configure, deploy, or troubleshoot an Aspire distributed application.	references/architecture.md references/cli-reference.md references/dashboard.md references/deployment.md references/integrations-catalog.md references/mcp-server.md references/polyglot-apis.md references/testing.md references/troubleshooting.md
azure-deployment-preflight	Performs comprehensive preflight validation of Bicep deployments to Azure, including template syntax validation, what-if analysis, and permission checks. Use this skill before any deployment to Azure to preview changes, identify potential issues, and ensure the deployment will succeed. Activate when users mention deploying to Azure, validating Bicep files, checking deployment permissions, previewing infrastructure changes, running what-if, or preparing for azd provision.	references/ERROR-HANDLING.md references/REPORT-TEMPLATE.md references/VALIDATION-COMMANDS.md
azure-devops-cli	Manage Azure DevOps resources via CLI including projects, repos, pipelines, builds, pull requests, work items, artifacts, and service endpoints. Use when working with Azure DevOps, az commands, devops automation, CI/CD, or when user mentions Azure DevOps CLI.	None
azure-resource-visualizer	Analyze Azure resource groups and generate detailed Mermaid architecture diagrams showing the relationships between individual resources. Use this skill when the user asks for a diagram of their Azure resources or help in understanding how the resources relate to each other.	LICENSE.txt assets/template-architecture.md
azure-role-selector	When user is asking for guidance for which role to assign to an identity given desired permissions, this agent helps them understand the role that will meet the requirements with least privilege access and how to apply that role.	LICENSE.txt
azure-static-web-apps	Helps create, configure, and deploy Azure Static Web Apps using the SWA CLI. Use when deploying static sites to Azure, setting up SWA local development, configuring staticwebapp.config.json, adding Azure Functions APIs to SWA, or setting up GitHub Actions CI/CD for Static Web Apps.	None
chrome-devtools	Expert-level browser automation, debugging, and performance analysis using Chrome DevTools MCP. Use for interacting with web pages, capturing screenshots, analyzing network traffic, and profiling performance.	None
copilot-cli-quickstart	Use this skill when someone wants to learn GitHub Copilot CLI from scratch. Offers interactive step-by-step tutorials with separate Developer and Non-Developer tracks, plus on-demand Q&A. Just say "start tutorial" or ask a question! Note: This skill targets GitHub Copilot CLI specifically and uses CLI-specific tools (ask_user, sql, fetch_copilot_cli_documentation).	None
copilot-sdk	Build agentic applications with GitHub Copilot SDK. Use when embedding AI agents in apps, creating custom tools, implementing streaming responses, managing sessions, connecting to MCP servers, or creating custom agents. Triggers on Copilot SDK, GitHub SDK, agentic app, embed Copilot, programmable agent, MCP server, custom agent.	None
create-web-form	Create robust, accessible web forms with best practices for HTML structure, CSS styling, JavaScript interactivity, form validation, and server-side processing. Use when asked to "create a form", "build a web form", "add a contact form", "make a signup form", or when building any HTML form with data handling. Covers PHP and Python backends, MySQL database integration, REST APIs, XML data exchange, accessibility (ARIA), and progressive web apps.	references/accessibility.md references/aria-form-role.md references/css-styling.md references/form-basics.md references/form-controls.md references/form-data-handling.md references/html-form-elements.md references/html-form-example.md references/hypertext-transfer-protocol.md references/javascript.md references/php-cookies.md references/php-forms.md references/php-json.md references/php-mysql-database.md references/progressive-web-app.md references/python-as-web-framework.md references/python-contact-form.md references/python-flask-app.md references/python-flask.md references/security.md references/styling-web-forms.md references/web-api.md references/web-performance.md references/xml.md
excalidraw-diagram-generator	Generate Excalidraw diagrams from natural language descriptions. Use when asked to "create a diagram", "make a flowchart", "visualize a process", "draw a system architecture", "create a mind map", or "generate an Excalidraw file". Supports flowcharts, relationship diagrams, mind maps, and system architecture diagrams. Outputs .excalidraw JSON files that can be opened directly in Excalidraw.	references/element-types.md references/excalidraw-schema.md scripts/.gitignore scripts/README.md scripts/add-arrow.py scripts/add-icon-to-diagram.py scripts/split-excalidraw-library.py templates/business-flow-swimlane-template.excalidraw templates/class-diagram-template.excalidraw templates/data-flow-diagram-template.excalidraw templates/er-diagram-template.excalidraw templates/flowchart-template.excalidraw templates/mindmap-template.excalidraw templates/relationship-template.excalidraw templates/sequence-diagram-template.excalidraw
gh-cli	GitHub CLI (gh) comprehensive reference for repositories, issues, pull requests, Actions, projects, releases, gists, codespaces, organizations, extensions, and all GitHub operations from the command line.	None
git-commit	Execute git commit with conventional commit message analysis, intelligent staging, and message generation. Use when user asks to commit changes, create a git commit, or mentions "/commit". Supports: (1) Auto-detecting type and scope from changes, (2) Generating conventional commit messages from diff, (3) Interactive commit with optional type/scope/description overrides, (4) Intelligent file staging for logical grouping	None
github-issues	Create, update, and manage GitHub issues using MCP tools. Use this skill when users want to create bug reports, feature requests, or task issues, update existing issues, add labels/assignees/milestones, or manage issue workflows. Triggers on requests like "create an issue", "file a bug", "request a feature", "update issue X", or any GitHub issue management task.	references/templates.md
image-manipulation-image-magick	Process and manipulate images using ImageMagick. Supports resizing, format conversion, batch processing, and retrieving image metadata. Use when working with images, creating thumbnails, resizing wallpapers, or performing batch image operations.	None
legacy-circuit-mockups	Generate breadboard circuit mockups and visual diagrams using HTML5 Canvas drawing techniques. Use when asked to create circuit layouts, visualize electronic component placements, draw breadboard diagrams, mockup 6502 builds, generate retro computer schematics, or design vintage electronics projects. Supports 555 timers, W65C02S microprocessors, 28C256 EEPROMs, W65C22 VIA chips, 7400-series logic gates, LEDs, resistors, capacitors, switches, buttons, crystals, and wires.	references/28256-eeprom.md references/555.md references/6502.md references/6522.md references/6C62256.md references/7400-series.md references/assembly-compiler.md references/assembly-language.md references/basic-electronic-components.md references/breadboard.md references/common-breadboard-components.md references/connecting-electronic-components.md references/emulator-28256-eeprom.md references/emulator-6502.md references/emulator-6522.md references/emulator-6C62256.md references/emulator-lcd.md references/lcd.md references/minipro.md references/t48eeprom-programmer.md
make-repo-contribution	All changes to code must follow the guidance documented in the repository. Before any issue is filed, branch is made, commits generated, or pull request (or PR) created, a search must be done to ensure the right steps are followed. Whenever asked to create an issue, commit messages, to push code, or create a PR, use this skill so everything is done correctly.	assets/issue-template.md assets/pr-template.md
make-skill-template	Create new Agent Skills for GitHub Copilot from prompts or by duplicating this template. Use when asked to "create a skill", "make a new skill", "scaffold a skill", or when building specialized AI capabilities with bundled resources. Generates SKILL.md files with proper frontmatter, directory structure, and optional scripts/references/assets folders.	None
markdown-to-html	Convert Markdown files to HTML similar to marked.js, pandoc, gomarkdown/markdown, or similar tools; or writing custom script to convert markdown to html and/or working on web template systems like jekyll/jekyll, gohugoio/hugo, or similar web templating systems that utilize markdown documents, converting them to html. Use when asked to "convert markdown to html", "transform md to html", "render markdown", "generate html from markdown", or when working with .md files and/or web a templating system that converts markdown to HTML output. Supports CLI and Node.js workflows with GFM, CommonMark, and standard Markdown flavors.	references/basic-markdown-to-html.md references/basic-markdown.md references/code-blocks-to-html.md references/code-blocks.md references/collapsed-sections-to-html.md references/collapsed-sections.md references/gomarkdown.md references/hugo.md references/jekyll.md references/marked.md references/pandoc.md references/tables-to-html.md references/tables.md references/writing-mathematical-expressions-to-html.md references/writing-mathematical-expressions.md
mcp-cli	Interface for MCP (Model Context Protocol) servers via CLI. Use when you need to interact with external tools, APIs, or data sources through MCP servers, list available MCP servers/tools, or call MCP tools from command line.	None
meeting-minutes	Generate concise, actionable meeting minutes for internal meetings. Includes metadata, attendees, agenda, decisions, action items (owner + due date), and follow-up steps.	None
microsoft-code-reference	Look up Microsoft API references, find working code samples, and verify SDK code is correct. Use when working with Azure SDKs, .NET libraries, or Microsoft APIs—to find the right method, check parameters, get working examples, or troubleshoot errors. Catches hallucinated methods, wrong signatures, and deprecated patterns by querying official docs.	None
microsoft-docs	Query official Microsoft documentation to find concepts, tutorials, and code examples across Azure, .NET, Agent Framework, Aspire, VS Code, GitHub, and more. Uses Microsoft Learn MCP as the default, with Context7 and Aspire MCP for content that lives outside learn.microsoft.com.	None
microsoft-skill-creator	Create agent skills for Microsoft technologies using Learn MCP tools. Use when users want to create a skill that teaches agents about any Microsoft technology, library, framework, or service (Azure, .NET, M365, VS Code, Bicep, etc.). Investigates topics deeply, then generates a hybrid skill storing essential knowledge locally while enabling dynamic deeper investigation.	references/skill-templates.md
nano-banana-pro-openrouter	Generate or edit images via OpenRouter with the Gemini 3 Pro Image model. Use for prompt-only image generation, image edits, and multi-image compositing; supports 1K/2K/4K output.	assets/SYSTEM_TEMPLATE scripts/generate_image.py
nuget-manager	Manage NuGet packages in .NET projects/solutions. Use this skill when adding, removing, or updating NuGet package versions. It enforces using dotnet CLI for package management and provides strict procedures for direct file edits only when updating versions.	None
penpot-uiux-design	Comprehensive guide for creating professional UI/UX designs in Penpot using MCP tools. Use this skill when: (1) Creating new UI/UX designs for web, mobile, or desktop applications, (2) Building design systems with components and tokens, (3) Designing dashboards, forms, navigation, or landing pages, (4) Applying accessibility standards and best practices, (5) Following platform guidelines (iOS, Android, Material Design), (6) Reviewing or improving existing Penpot designs for usability. Triggers: "design a UI", "create interface", "build layout", "design dashboard", "create form", "design landing page", "make it accessible", "design system", "component library".	references/accessibility.md references/component-patterns.md references/platform-guidelines.md references/setup-troubleshooting.md
plantuml-ascii	Generate ASCII art diagrams using PlantUML text mode. Use when user asks to create ASCII diagrams, text-based diagrams, terminal-friendly diagrams, or mentions plantuml ascii, text diagram, ascii art diagram. Supports: Converting PlantUML diagrams to ASCII art, Creating sequence diagrams, class diagrams, flowcharts in ASCII format, Generating Unicode-enhanced ASCII art with -utxt flag	None
powerbi-modeling	Power BI semantic modeling assistant for building optimized data models. Use when working with Power BI semantic models, creating measures, designing star schemas, configuring relationships, implementing RLS, or optimizing model performance. Triggers on queries about DAX calculations, table relationships, dimension/fact table design, naming conventions, model documentation, cardinality, cross-filter direction, calculation groups, and data model best practices. Always connects to the active model first using power-bi-modeling MCP tools to understand the data structure before providing guidance.	references/MEASURES-DAX.md references/PERFORMANCE.md references/RELATIONSHIPS.md references/RLS.md references/STAR-SCHEMA.md
prd	Generate high-quality Product Requirements Documents (PRDs) for software systems and AI-powered features. Includes executive summaries, user stories, technical specifications, and risk analysis.	None
refactor	Surgical code refactoring to improve maintainability without changing behavior. Covers extracting functions, renaming variables, breaking down god functions, improving type safety, eliminating code smells, and applying design patterns. Less drastic than repo-rebuilder; use for gradual improvements.	None
scoutqa-test	This skill should be used when the user asks to "test this website", "run exploratory testing", "check for accessibility issues", "verify the login flow works", "find bugs on this page", or requests automated QA testing. Triggers on web application testing scenarios including smoke tests, accessibility audits, e-commerce flows, and user flow validation using ScoutQA CLI. IMPORTANT: Use this skill proactively after implementing web application features to verify they work correctly - don't wait for the user to ask for testing.	None
snowflake-semanticview	Create, alter, and validate Snowflake semantic views using Snowflake CLI (snow). Use when asked to build or troubleshoot semantic views/semantic layer definitions with CREATE/ALTER SEMANTIC VIEW, to validate semantic-view DDL against Snowflake via CLI, or to guide Snowflake CLI installation and connection setup.	None
sponsor-finder	Find which of a GitHub repository's dependencies are sponsorable via GitHub Sponsors. Uses deps.dev API for dependency resolution across npm, PyPI, Cargo, Go, RubyGems, Maven, and NuGet. Checks npm funding metadata, FUNDING.yml files, and web search. Verifies every link. Shows direct and transitive dependencies with OSSF Scorecard health data. Invoke with /sponsor followed by a GitHub owner/repo (e.g. "/sponsor expressjs/express").	None
terraform-azurerm-set-diff-analyzer	Analyze Terraform plan JSON output for AzureRM Provider to distinguish between false-positive diffs (order-only changes in Set-type attributes) and actual resource changes. Use when reviewing terraform plan output for Azure resources like Application Gateway, Load Balancer, Firewall, Front Door, NSG, and other resources with Set-type attributes that cause spurious diffs due to internal ordering changes.	references/azurerm_set_attributes.json references/azurerm_set_attributes.md scripts/.gitignore scripts/README.md scripts/analyze_plan.py
vscode-ext-commands	Guidelines for contributing commands in VS Code extensions. Indicates naming convention, visibility, localization and other relevant attributes, following VS Code extension development guidelines, libraries and good practices	None
vscode-ext-localization	Guidelines for proper localization of VS Code extensions, following VS Code extension development guidelines, libraries and good practices	None
web-design-reviewer	This skill enables visual inspection of websites running locally or remotely to identify and fix design issues. Triggers on requests like "review website design", "check the UI", "fix the layout", "find design problems". Detects issues with responsive design, accessibility, visual consistency, and layout breakage, then performs fixes at the source code level.	references/framework-fixes.md references/visual-checklist.md
webapp-testing	Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.	test-helper.js
winapp-cli	Windows App Development CLI (winapp) for building, packaging, and deploying Windows applications. Use when asked to initialize Windows app projects, create MSIX packages, generate AppxManifest.xml, manage development certificates, add package identity for debugging, sign packages, or access Windows SDK build tools. Supports .NET, C++, Electron, Rust, Tauri, and cross-platform frameworks targeting Windows.	None
workiq-copilot	Guides the Copilot CLI on how to use the WorkIQ CLI/MCP server to query Microsoft 365 Copilot data (emails, meetings, docs, Teams, people) for live context, summaries, and recommendations.	None