migrate-agents-to-copilot-instructions

Installation
SKILL.md

Migrate AGENTS.md to GitHub Copilot Instructions

Use this skill to convert repository guidance from AGENTS.md files into GitHub Copilot custom instruction files without losing scope or intent.

For exact file names, supported locations, and official syntax, read references/github-copilot-instructions.md before writing the target files.

What to migrate where

Map guidance by scope instead of copying file-for-file blindly:

  • Put repository-wide guidance into .github/copilot-instructions.md.
  • Put subtree-specific guidance into .github/instructions/NAME.instructions.md.
  • Keep AGENTS.md files unless the user explicitly asks you to remove them.

Why: GitHub Copilot combines repository-wide instructions with matching path-specific instructions, but AGENTS.md files still matter in some Copilot surfaces and other agent ecosystems.

Migration workflow

  1. Inventory the current instruction sources:
Related skills
Installs
1
First Seen
Mar 10, 2026