💫 Toolkit to help you get started with SDD or any other process!
docs: document copilot skills mode (--skills) and markdown deprecation (#3313)
Quratulain-bilala10fd2f3554d
diff --git a/docs/reference/integrations.md b/docs/reference/integrations.mdindex f538fac86..df5e8801e 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` | Defaults to legacy markdown mode: `.agent.md` command files under `.github/agents/`, companion `.prompt.md` files under `.github/prompts/`, and a `.vscode/settings.json` merge. Pass `--integration-options="--skills"` to scaffold skills as `speckit-<command>/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,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-<command>/SKILL.md` under `.github/skills/`, invoked as `/speckit-<command>`) instead of the default legacy markdown mode (`.github/agents/*.agent.md` plus `.github/prompts/*.prompt.md` and a `.vscode/settings.json` merge). Without this flag, install warns that legacy markdown mode is deprecated. |Example: