From b81fff4702ea550a5ea9ef57fc547e93148abf21 Mon Sep 17 00:00:00 2001 From: hubwriter Date: Mon, 22 Sep 2025 16:50:53 +0100 Subject: [PATCH] Clarify Copilot custom instructions support across multiple platforms & Copilot features (#57587) --- .../add-repository-instructions.md | 5 ----- .../repository-custom-instructions-support.md | 22 ++++++++++++++++--- 2 files changed, 19 insertions(+), 8 deletions(-) diff --git a/content/copilot/how-tos/configure-custom-instructions/add-repository-instructions.md b/content/copilot/how-tos/configure-custom-instructions/add-repository-instructions.md index f7348dd946..f9c37a365d 100644 --- a/content/copilot/how-tos/configure-custom-instructions/add-repository-instructions.md +++ b/content/copilot/how-tos/configure-custom-instructions/add-repository-instructions.md @@ -20,7 +20,6 @@ redirect_from: This version of this article is for using repository custom instructions on the {% data variables.product.github %} website. Click the tabs above for information on using custom instructions in other environments. {% data reusables.copilot.repository-custom-instructions-support %} -* **{% data variables.copilot.copilot_code-review_short %}** {% data reusables.copilot.repository-custom-instructions-prerequisites %} @@ -31,7 +30,6 @@ This version of this article is for using repository custom instructions on the This version of this article is for using repository custom instructions and prompt files in {% data variables.product.prodname_vscode_shortname %}. Click the tabs above for instructions on using custom instructions in other environments. {% data reusables.copilot.repository-custom-instructions-support %} -* **{% data variables.copilot.copilot_code-review_short %}** {% data reusables.copilot.repository-custom-instructions-prerequisites %} @@ -42,7 +40,6 @@ This version of this article is for using repository custom instructions and pro This version of this article is for using repository custom instructions in {% data variables.product.prodname_vs %}. Click the tabs above for instructions on using custom instructions in other environments. {% data reusables.copilot.repository-custom-instructions-support %} -* **{% data variables.copilot.copilot_code-review_short %}** {% data reusables.copilot.repository-custom-instructions-prerequisites %} @@ -53,7 +50,6 @@ This version of this article is for using repository custom instructions in {% d This version of this article is for using repository custom instructions in JetBrains IDEs. Click the tabs above for instructions on using custom instructions in other environments. {% data reusables.copilot.repository-custom-instructions-support %} -* **{% data variables.copilot.copilot_code-review_short %}** {% data reusables.copilot.repository-custom-instructions-prerequisites %} @@ -76,7 +72,6 @@ This version of this article is for using repository custom instructions in Xcod This version of this article is for using repository custom instructions in Eclipse. Click the tabs above for instructions on using custom instructions in other environments. {% data reusables.copilot.repository-custom-instructions-support %} -* **{% data variables.copilot.copilot_code-review_short %}** {% data reusables.copilot.repository-custom-instructions-prerequisites %} diff --git a/data/reusables/copilot/repository-custom-instructions-support.md b/data/reusables/copilot/repository-custom-instructions-support.md index 2a2bdbf239..9fe11adea3 100644 --- a/data/reusables/copilot/repository-custom-instructions-support.md +++ b/data/reusables/copilot/repository-custom-instructions-support.md @@ -2,6 +2,22 @@ Repository custom instructions let you provide {% data variables.product.prodname_copilot_short %} with repository-specific guidance and preferences. -Repository custom instructions are currently supported for: -* **{% data variables.copilot.copilot_coding_agent %}** -* **{% data variables.copilot.copilot_chat_short %}** +### Support for repository custom instructions + +The following table shows which {% data variables.product.prodname_copilot_short %} features support the `.github/copilot-instructions.md` instructions file. + +{% rowheaders %} + +| | Eclipse | JetBrains IDEs | {% data variables.product.prodname_vs %} | {% data variables.product.prodname_vscode_shortname %} | {% data variables.product.prodname_dotcom_the_website %} | Xcode | +| --- | --- | --- | --- | --- | --- | --- | +| {% data variables.copilot.copilot_chat_short %} | {% octicon "check" aria-label="Included" %} 1 | {% octicon "check" aria-label="Included" %} 1 | {% octicon "check" aria-label="Included" %} 1 | {% octicon "check" aria-label="Included" %} 1 | {% octicon "check" aria-label="Included" %} 1 | {% octicon "check" aria-label="Included" %} 1 | +| {% data variables.copilot.copilot_coding_agent %} | N/A | N/A | N/A | {% octicon "check" aria-label="Included" %} 3 | {% octicon "check" aria-label="Included" %} 3 | N/A | +| {% data variables.copilot.copilot_code-review_short %} | N/A | {% octicon "x" aria-label="Not included" %} | {% octicon "check" aria-label="Included" %} 1 | {% octicon "check" aria-label="Included" %} 2 | {% octicon "check" aria-label="Included" %} 2 | {% octicon "x" aria-label="Not included" %} | + +{% endrowheaders %} + +**1:** Repository-wide instructions (using the `.github/copilot-instructions.md` file) are supported.
+**2:** Repository-wide instructions and path-specific instructions (using `.github/instructions/NAME.instructions.md` files) are supported.
+**3:** Repository-wide instructions, path-specific instructions, and agent instructions (using `AGENTS.md`, `CLAUDE.md` or `GEMINI.md` files) are supported.
+**X:** Custom instructions are not supported.
+**N/A:** Feature not available on this platform.