New to GitHub Copilot customization? This glossary defines common terms youâll encounter while exploring agents, skills, instructions, and related concepts in the Awesome GitHub Copilot ecosystem.
Use this page as a quick reference when reading articles in the Learning Hub or browsing the repository.
Core Concepts
Agent
A specialized configuration file (*.agent.md) that defines a GitHub Copilot persona or assistant with specific expertise, tools, and behavior patterns. Agents integrate with MCP servers to provide enhanced capabilities for particular workflows (e.g., âTerraform Expertâ or âSecurity Auditorâ).
When to use: For recurring workflows that benefit from deep tooling integrations and persistent conversational context.
Learn more: What are Agents, Skills, and Instructions
Built-in Tool
A native capability provided by GitHub Copilot without requiring additional configuration or MCP servers. Examples include code search, file editing, terminal command execution, and web search. Built-in tools are always available and donât require installation.
Chat Mode
Deprecated terminology - This term is no longer used. Use Agent instead.
Previously, âchat modeâ was an alternative term for Agent that described how GitHub Copilot Chat could be transformed into domain-specific assistants. The ecosystem has standardized on âAgentâ as the preferred terminology.
See: Agent
Collection
Note: Collections are a concept specific to the Awesome GitHub Copilot repository and are not part of standard GitHub Copilot terminology.
A curated grouping of related skills, instructions, and agents organized around a specific theme or workflow. Collections are defined in YAML files (*.collection.yml) in the collections/ directory and help users discover related customizations together.
Example: The âAwesome Copilotâ collection bundles meta-skills for discovering and generating GitHub Copilot customizations.
Learn more: What are Agents, Skills, and Instructions
Custom Agent
See Agent. The term âcustomâ emphasizes that these are user-defined configurations rather than GitHub Copilotâs default behavior. Custom agents can be created by anyone and shared via repositories like Awesome GitHub Copilot.
Custom Instruction
See Instruction. The term âcustomâ emphasizes that these are user-defined rules rather than GitHub Copilotâs built-in understanding. Custom instructions are particularly useful for codifying team-specific standards and architectural decisions.
Configuration & Metadata
Front Matter
YAML metadata placed at the beginning of Markdown files (between --- delimiters) that provides structured information about the file and controls its behavior. In this repository, front matter typically includes fields like name, description, mode, model, tools, and applyTo.
The front matter is what controls:
- Tool access: Which built-in and MCP tools the customization can use
- Model selection: Which AI model powers the customization
- Scope: Where the customization applies (e.g.,
applyTopatterns for instructions)
Note: Not all fields are common across all customization types. Refer to the specific documentation for agents, skills, or instructions to see which fields apply to each type.
Example:
---
name: 'React Component Generator'
description: 'Generate modern React components with TypeScript'
mode: 'agent'
tools: ['codebase']
---
Used in: Skills, agents, instructions, and Learning Hub articles.
AGENTS.md
An emerging industry standard file format for defining portable AI coding instructions that work across different AI coding tools (GitHub Copilot, Claude, Codex, and others). The AGENTS.md file, typically placed in a repository root or .github/ directory, contains instructions for how AI assistants should interact with your codebase.
Unlike tool-specific customization files (.agent.md, .prompt.md, .instructions.md), AGENTS.md aims to provide a standardized, platform-agnostic way to define AI behavior that can be consumed by multiple tools.
Key characteristics:
- Platform-agnostic format for cross-tool compatibility
- Typically contains project context, coding standards, and architectural guidelines
- Located at repository root or in
.github/directory
Learn more: AGENTS.md Specification
Related terms: Instruction, Front Matter
Instruction
A configuration file (*.instructions.md) that provides persistent background context and coding standards that GitHub Copilot reads whenever working on matching files. Instructions contain style guides, framework-specific hints, and repository rules that help Copilot align with your engineering practices automatically.
When to use: For long-lived guidance that applies across many sessions, like coding standards or compliance requirements.
Learn more: What are Agents, Skills, and Instructions, Defining Custom Instructions
Skills & Interactions
Persona
The identity, tone, and behavioral characteristics defined for an Agent. A well-crafted persona helps GitHub Copilot respond consistently and appropriately for specific domains or expertise areas.
Example: A âDatabase Performance Expertâ persona might prioritize query optimization and explain concepts using database-specific terminology.
Related terms: Agent
Prompt
Deprecated â Prompts (*.prompt.md) were reusable chat templates that captured specific tasks or workflows, invoked using the / command in GitHub Copilot Chat. Prompts have been superseded by Skills, which offer the same slash-command invocation plus agent discovery, bundled assets, and cross-platform portability.
If you have existing prompts, consider migrating them to skills. See Creating Effective Skills for guidance.
See: Skill
Skill
A self-contained folder containing a SKILL.md file and optional bundled assets (reference documents, templates, scripts) that packages a reusable capability for GitHub Copilot. Skills follow the open Agent Skills specification and can be invoked by users via /command or discovered and invoked by agents automatically.
Key advantages:
- Agent discovery: Extended frontmatter lets agents find and invoke skills automatically
- Bundled assets: Reference files, templates, and scripts provide richer context
- Cross-platform: Portable across coding agent systems via the Agent Skills specification
Example: A /generate-tests skill might include a SKILL.md with testing instructions, a references/test-patterns.md with common patterns, and a templates/test-template.ts starter file.
When to use: For standardizing how Copilot responds to recurring tasks, especially when bundled resources improve quality.
Learn more: What are Agents, Skills, and Instructions, Creating Effective Skills
Platform & Integration
MCP (Model Context Protocol)
A standardized protocol for connecting AI assistants like GitHub Copilot to external data sources, tools, and services. MCP servers act as bridges, allowing Copilot to interact with APIs, databases, file systems, and other resources beyond its built-in capabilities.
Example: An MCP server might provide access to your companyâs internal documentation, AWS resources, or a specific database system.
Learn more: Model Context Protocol | MCP Specification | Understanding MCP Servers
Related terms: Tools, Built-in Tool
Hook
A shell command or script that runs automatically in response to lifecycle events during a Copilot agent session. Hooks are stored as JSON files in .github/hooks/ and can trigger on events like session start/end, prompt submission, before/after tool use, and when errors occur. They provide deterministic automationâlinting, formatting, governance scanningâthat doesnât depend on the AI remembering to do it.
Example: A postToolUse hook that runs Prettier after the agent edits files, or a preToolUse hook that blocks dangerous shell commands.
When to use: For deterministic automation that must happen reliably, like formatting code, running linters, or auditing prompts for compliance.
Learn more: Automating with Hooks
Related terms: Agent, Coding Agent
Coding Agent
The autonomous GitHub Copilot agent that works on issues in a cloud environment without continuous human guidance. You assign an issue to Copilot, it spins up a dev environment, implements a solution, runs tests, and opens a pull request for review.
Key characteristics:
- Runs in an isolated cloud environment
- Uses your repositoryâs instructions, agents, skills, and hooks
- Always produces a PRâit canât merge or deploy
- Supports iteration via PR comments
When to use: For well-defined tasks with clear acceptance criteria that can be completed autonomously.
Learn more: Using the Copilot Coding Agent
Plugin
An installable package that extends GitHub Copilot CLI with a bundled set of agents, skills, hooks, MCP server configurations, and LSP integrations. Plugins provide a way to distribute and share custom capabilities across projects and teams, with versioning, discovery, and one-command installation via marketplaces.
Example: Installing database-data-management@awesome-copilot to get a database specialist agent, migration skills, and schema validation hooks in a single command.
When to use: When you want to share a curated set of Copilot capabilities across multiple projects or team members, or when you want to install community-contributed tooling without manually copying files.
Learn more: Installing and Using Plugins
Related terms: Agent, Skill, Hook
Tools
Capabilities that GitHub Copilot can invoke to perform actions or retrieve information. Tools fall into two categories:
- Built-in tools: Native capabilities like
codebase(code search),terminalCommand(running commands), andweb(web search) - MCP tools: External integrations provided by MCP servers (e.g., database queries, cloud resource management, or API calls)
Agents and skills can specify which tools they require or recommend in their front matter.
Example front matter:
tools: ['codebase', 'terminalCommand', 'github']
Related terms: MCP, Built-in Tool, Agent
Have a term youâd like to see added? Contributions are welcome! See our Contributing Guidelines for how to suggest additions to this glossary.