creating-agent-skills

Guide creation and structure of GitHub Copilot Agent Skills with SKILL.md formatting.

5|1|Updated Feb 9, 2026
One-click install
npx skills add https://github.com/JerryNixon/github-copilot-sql-dab-azure-mcp --skill creating-agent-skills-jerrynixon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: creating-agent-skills
Source: https://github.com/JerryNixon/github-copilot-sql-dab-azure-mcp/tree/main/.github/skills/creating-agent-skills
Command: npx skills add https://github.com/JerryNixon/github-copilot-sql-dab-azure-mcp --skill creating-agent-skills-jerrynixon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a comprehensive guide for creating and structuring effective Agent Skills for GitHub Copilot, ensuring clarity, discoverability, and functionality.

Core Features & Use Cases

  • Skill Structure: Understand the required directory and file naming conventions.
  • SKILL.md Format: Learn the essential YAML frontmatter and content structure.
  • Best Practices: Follow guidelines for writing effective descriptions, content, and code examples.
  • Use Case: When you need to create a new skill for Copilot to help developers debug CI/CD pipelines, use this skill to understand the best way to structure the SKILL.md file, include relevant scripts, and write a clear description.

Quick Start

Use this skill to learn how to create a new GitHub Copilot Agent Skill.

Frequently Asked Questions about creating-agent-skills

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a GitHub Copilot agent skill?

To create a GitHub Copilot agent skill, you must follow specific directory naming conventions and format your instructions within a `SKILL.md` file. This process ensures your skill is discoverable and provides actionable instructions for the AI agent.

What is the required format for a SKILL.md file?

The required format for a `SKILL.md` file includes YAML frontmatter for metadata and structured content sections. Proper formatting ensures the AI agent can parse instructions, understand descriptions, and execute the intended tasks accurately.

What are the best practices for writing agent skill descriptions?

Best practices for writing agent skill descriptions emphasize clarity and discoverability. You should write effective descriptions that clearly state the skill's purpose, include relevant keywords, and provide actionable instructions for the AI agent.

How should I structure content in a Copilot skill?

You should structure content in a Copilot skill by organizing the `SKILL.md` file with clear sections for instructions, code examples, and troubleshooting. This organization helps the AI agent process the information logically and apply it correctly.

Do I need specific directory organization for GitHub Copilot skills?

Yes, specific directory organization is required for GitHub Copilot skills. Understanding and applying the correct directory and file naming conventions is essential for the skill to be recognized and function properly within the environment.