From a224bac2fa86e06de92df6d4c50d09d8aa49b70f Mon Sep 17 00:00:00 2001
From: 0xdx2 <xuedamon2@gmail.com>
Date: Tue, 10 Mar 2026 13:31:55 +0800
Subject: [PATCH] feat: Add Github Copilot integration and installation
 instructions

---
 README.md                             | 34 +++++++++++++++++++++------
 integrations/github-copilot/README.md | 31 ++++++++++++++++++++++++
 2 files changed, 58 insertions(+), 7 deletions(-)
 create mode 100644 integrations/github-copilot/README.md

diff --git a/README.md b/README.md
index b6cad18..1f9afdf 100644
--- a/README.md
+++ b/README.md
@@ -55,6 +55,7 @@ Browse the agents below and copy/adapt the ones you need!
 
 # Or target a specific tool directly
 ./scripts/install.sh --tool cursor
+./scripts/install.sh --tool copilot
 ./scripts/install.sh --tool aider
 ./scripts/install.sh --tool windsurf
 ```
@@ -339,6 +340,7 @@ The Agency works natively with Claude Code, and ships conversion + install scrip
 ### Supported Tools
 
 - **[Claude Code](https://claude.ai/code)** — native `.md` agents, no conversion needed → `~/.claude/agents/`
+- **[Github Copilot](https://github.com/copilot)** — native `.md` agents, no conversion needed → `~/.github/agents/`
 - **[Antigravity](https://github.com/google-gemini/antigravity)** — `SKILL.md` per agent → `~/.gemini/antigravity/skills/`
 - **[Gemini CLI](https://github.com/google-gemini/gemini-cli)** — extension + `SKILL.md` files → `~/.gemini/extensions/agency-agents/`
 - **[OpenCode](https://opencode.ai)** — `.md` agent files → `.opencode/agent/`
@@ -370,14 +372,15 @@ The installer scans your system for installed tools, shows a checkbox UI, and le
   System scan: [*] = detected on this machine
 
   [x]  1)  [*]  Claude Code     (claude.ai/code)
-  [x]  2)  [*]  Antigravity     (~/.gemini/antigravity)
-  [ ]  3)  [ ]  Gemini CLI      (gemini extension)
-  [ ]  4)  [ ]  OpenCode        (opencode.ai)
-  [x]  5)  [*]  Cursor          (.cursor/rules)
-  [ ]  6)  [ ]  Aider           (CONVENTIONS.md)
-  [ ]  7)  [ ]  Windsurf        (.windsurfrules)
+  [x]  2)  [*]  Copilot         (~/.github/agents)
+  [x]  3)  [*]  Antigravity     (~/.gemini/antigravity)
+  [ ]  4)  [ ]  Gemini CLI      (gemini extension)
+  [ ]  5)  [ ]  OpenCode        (opencode.ai)
+  [x]  6)  [*]  Cursor          (.cursor/rules)
+  [ ]  7)  [ ]  Aider           (CONVENTIONS.md)
+  [ ]  8)  [ ]  Windsurf        (.windsurfrules)
 
-  [1-7] toggle   [a] all   [n] none   [d] detected
+  [1-8] toggle   [a] all   [n] none   [d] detected
   [Enter] install   [q] quit
 ```
 
@@ -414,6 +417,23 @@ Use the Frontend Developer agent to review this component.
 See [integrations/claude-code/README.md](integrations/claude-code/README.md) for details.
 </details>
 
+<details>
+<summary><strong>Github Copilot</strong></summary>
+
+Agents are copied directly from the repo into `~/.github/agents/` -- no conversion needed.
+
+```bash
+./scripts/install.sh --tool copilot
+```
+
+Then activate in Github Copilot:
+```
+Use the Frontend Developer agent to review this component.
+```
+
+See [integrations/github-copilot/README.md](integrations/github-copilot/README.md) for details.
+</details>
+
 <details>
 <summary><strong>Antigravity (Gemini)</strong></summary>
 
diff --git a/integrations/github-copilot/README.md b/integrations/github-copilot/README.md
new file mode 100644
index 0000000..0d2b27b
--- /dev/null
+++ b/integrations/github-copilot/README.md
@@ -0,0 +1,31 @@
+# Github Copilot Integration
+
+The Agency was built for Github Copilot. No conversion needed — agents work
+natively with the existing `.md` + YAML frontmatter format.
+
+## Install
+
+```bash
+# Copy all agents to your Github Copilot agents directory
+./scripts/install.sh --tool copilot
+
+# Or manually copy a category
+cp engineering/*.md ~/.github/agents/
+```
+
+## Activate an Agent
+
+In any Github Copilot session, reference an agent by name:
+
+```
+Activate Frontend Developer and help me build a React component.
+```
+
+```
+Use the Reality Checker agent to verify this feature is production-ready.
+```
+
+## Agent Directory
+
+Agents are organized into divisions. See the [main README](../../README.md) for
+the full roster of 61 specialists.