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: