From a04e200a697d20b594c931e6793209240840ebef Mon Sep 17 00:00:00 2001 From: Quratulain-bilal Date: Fri, 3 Jul 2026 01:10:13 +0500 Subject: [PATCH 1/2] docs: document copilot skills mode (--skills) and markdown deprecation as of #3256 (v0.12.3) the copilot integration supports a skills mode via `--integration-options "--skills"`, and installing without it warns that the legacy markdown default is being phased out. this was undocumented: - the copilot row in the supported-agents table had an empty notes cell while other skills-capable agents describe their behavior there. - `--skills` was missing from the integration-specific options table (only generic and kimi were listed). fill both. wording matches the code: skills scaffold as speckit-/SKILL.md under .github/skills/ and are invoked as /speckit-; without the flag the install emits the deprecation warning from _warn_legacy_markdown_default(). fixes #3300 --- docs/reference/integrations.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/reference/integrations.md b/docs/reference/integrations.md index f538fac86f..b98547ee47 100644 --- a/docs/reference/integrations.md +++ b/docs/reference/integrations.md @@ -18,7 +18,7 @@ The Specify CLI supports a wide range of AI coding agents. When you run `specify | [Firebender](https://firebender.com/) | `firebender` | IDE-based agent for Android Studio / IntelliJ | | [Forge](https://forgecode.dev/) | `forge` | | | [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `gemini` | | -| [GitHub Copilot](https://code.visualstudio.com/) | `copilot` | | +| [GitHub Copilot](https://code.visualstudio.com/) | `copilot` | Installs `.agent.md` files by default. Pass `--integration-options "--skills"` to scaffold skills as `speckit-/SKILL.md` under `.github/skills/` instead. The markdown default is deprecated and will be phased out in a future release. | | [Goose](https://goose-docs.ai/) | `goose` | Uses YAML recipe format in `.goose/recipes/` | | [Hermes](https://github.com/NousResearch/hermes-agent) | `hermes` | Skills-based integration; installs skills globally into `~/.hermes/skills/` | | [IBM Bob](https://www.ibm.com/products/bob) | `bob` | IDE-based agent | @@ -219,6 +219,7 @@ Some integrations accept additional options via `--integration-options`: | ----------- | ------------------- | -------------------------------------------------------------- | | `generic` | `--commands-dir` | Required. Directory for command files | | `kimi` | `--migrate-legacy` | Migrate legacy `.kimi/skills/` installs to `.kimi-code/skills/` (including dotted→hyphenated skill naming, e.g. `speckit.xxx` → `speckit-xxx`) | +| `copilot` | `--skills` | Scaffold commands as agent skills (`speckit-/SKILL.md` under `.github/skills/`, invoked as `/speckit-`) instead of the default `.agent.md` files. Without this flag, install warns that the markdown default is deprecated. | Example: From 43f23af48d39f6ffc1d4ccda114b8ff6ab3d9cde Mon Sep 17 00:00:00 2001 From: Quratulain-bilal Date: Tue, 7 Jul 2026 04:59:37 +0500 Subject: [PATCH 2/2] docs: describe copilot default as legacy markdown mode (.agent.md + .prompt.md) the copilot rows said the default installs .agent.md files, but the default scaffold also writes companion .prompt.md files under .github/prompts/. also reworded to 'legacy markdown mode' to match the deprecation warning users actually see and to avoid ambiguity, since skills are markdown too. --- docs/reference/integrations.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/reference/integrations.md b/docs/reference/integrations.md index b98547ee47..85b9aa84ab 100644 --- a/docs/reference/integrations.md +++ b/docs/reference/integrations.md @@ -18,7 +18,7 @@ The Specify CLI supports a wide range of AI coding agents. When you run `specify | [Firebender](https://firebender.com/) | `firebender` | IDE-based agent for Android Studio / IntelliJ | | [Forge](https://forgecode.dev/) | `forge` | | | [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `gemini` | | -| [GitHub Copilot](https://code.visualstudio.com/) | `copilot` | Installs `.agent.md` files by default. Pass `--integration-options "--skills"` to scaffold skills as `speckit-/SKILL.md` under `.github/skills/` instead. The markdown default is deprecated and will be phased out in a future release. | +| [GitHub Copilot](https://code.visualstudio.com/) | `copilot` | Defaults to legacy markdown mode: `.agent.md` command files plus companion `.prompt.md` files under `.github/prompts/`. Pass `--integration-options "--skills"` to scaffold skills as `speckit-/SKILL.md` under `.github/skills/` instead. Legacy markdown mode is deprecated and will stop being the default in a future release. | | [Goose](https://goose-docs.ai/) | `goose` | Uses YAML recipe format in `.goose/recipes/` | | [Hermes](https://github.com/NousResearch/hermes-agent) | `hermes` | Skills-based integration; installs skills globally into `~/.hermes/skills/` | | [IBM Bob](https://www.ibm.com/products/bob) | `bob` | IDE-based agent | @@ -219,7 +219,7 @@ Some integrations accept additional options via `--integration-options`: | ----------- | ------------------- | -------------------------------------------------------------- | | `generic` | `--commands-dir` | Required. Directory for command files | | `kimi` | `--migrate-legacy` | Migrate legacy `.kimi/skills/` installs to `.kimi-code/skills/` (including dotted→hyphenated skill naming, e.g. `speckit.xxx` → `speckit-xxx`) | -| `copilot` | `--skills` | Scaffold commands as agent skills (`speckit-/SKILL.md` under `.github/skills/`, invoked as `/speckit-`) instead of the default `.agent.md` files. Without this flag, install warns that the markdown default is deprecated. | +| `copilot` | `--skills` | Scaffold commands as agent skills (`speckit-/SKILL.md` under `.github/skills/`, invoked as `/speckit-`) instead of the default legacy markdown mode (`.agent.md` + `.prompt.md`). Without this flag, install warns that legacy markdown mode is deprecated. | Example: