Skip to content

💫 Toolkit to help you get started with SDD or any other process!

docs: point the upgrade guide's Copilot checks at .github/skills (#5010)

yash9bc5c9dec301
diff --git a/docs/upgrade.md b/docs/upgrade.md
index c3c833059..4ceaa30d0 100644
--- a/docs/upgrade.md
+++ b/docs/upgrade.md
@@ -95,7 +95,7 @@ When Spec Kit releases new features (like new slash commands, updated templates,
For existing Spec Kit projects, use the manifest-aware upgrade path first:
-- ✅ **Integration command/skill files** (`.claude/skills/`, `.github/prompts/`, `.agents/skills/`, etc.)
+- ✅ **Integration command/skill files** (`.claude/skills/`, `.github/skills/`, `.agents/skills/`, etc.)
- ✅ **Managed shared scripts and templates** (`.specify/scripts/`, `.specify/templates/`) when they are unchanged from the previous managed copy
- ✅ **Installed extensions** when you run `specify extension update`
@@ -420,7 +420,7 @@ This warning appears when you run `specify init --here` (or `specify init .`) in
Only Spec Kit infrastructure files:
-- Agent command/skill files (`.claude/skills/`, `.github/prompts/`, etc.)
+- Agent command/skill files (`.claude/skills/`, `.github/skills/`, etc.)
- Scripts in `.specify/scripts/`
- Templates in `.specify/templates/`
- Missing memory files such as `.specify/memory/constitution.md` may be created from templates; an existing constitution is preserved
@@ -498,15 +498,19 @@ The `specify` CLI tool is used for:
- **Fallback recovery:** `specify init --here --force` when integration metadata is missing or the manifest-aware path cannot be used
- **Diagnostics:** `specify check` to verify tool installation
-Once you've run `specify init`, the slash commands (like `/speckit.specify`, `/speckit.plan`, etc.) are **permanently installed** in your project's agent folder (`.claude/`, `.github/prompts/`, `.pi/prompts/`, `.omp/commands/`, etc.). Your AI coding agent reads these command files directly—no need to run `specify` again.
+Once you've run `specify init`, the slash commands (like `/speckit.specify`, `/speckit.plan`, etc.) are **permanently installed** in your project's agent folder (`.claude/`, `.github/skills/`, `.pi/prompts/`, `.omp/commands/`, etc.). Your AI coding agent reads these command files directly—no need to run `specify` again.
**If your agent isn't recognizing slash commands:**
1. **Verify command files exist:**
```bash
- # For GitHub Copilot
- ls -la .github/prompts/
+ # For GitHub Copilot (default skills layout)
+ ls -la .github/skills/
+
+ # For GitHub Copilot with the commands layout (--integration-options="--commands",
+ # or a project created before skills became the default and upgraded since)
+ ls -la .github/agents/ .github/prompts/
# For Claude
ls -la .claude/skills/