Skip to content

Commit 31c784e

Browse files
tpopehubwriter
andauthored
Remove ~/.claude references from CLI docs (#60949)
Co-authored-by: hubwriter <hubwriter@github.com>
1 parent 1bf1619 commit 31c784e

5 files changed

Lines changed: 11 additions & 14 deletions

File tree

content/copilot/concepts/agents/about-agent-skills.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ You can also use `gh skill` in {% data variables.product.prodname_cli %} to disc
2525
{% data variables.product.prodname_copilot_short %} supports:
2626

2727
* Project skills, stored in your repository (`.github/skills`, `.claude/skills`, or `.agents/skills`)
28-
* Personal skills, stored in your home directory and shared across projects (`~/.copilot/skills`, `~/.claude/skills`, or `~/.agents/skills`)
28+
* Personal skills, stored in your home directory and shared across projects (`~/.copilot/skills` or `~/.agents/skills`)
2929

3030
Support for organization-level and enterprise-level skills is coming soon.
3131

content/copilot/reference/copilot-cli-reference/cli-command-reference.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1094,7 +1094,6 @@ Skills are loaded from these locations in priority order (first found wins for d
10941094
| Parent `.github/skills/` | Inherited | Monorepo parent directory support. |
10951095
| `~/.copilot/skills/` | Personal | Personal skills for all projects. |
10961096
| `~/.agents/skills/` | Personal | Agent skills shared across all projects. |
1097-
| `~/.claude/skills/` | Personal | Claude-compatible personal location. |
10981097
| Plugin directories | Plugin | Skills from installed plugins. |
10991098
| `COPILOT_SKILLS_DIRS` | Custom | Additional directories (comma-separated). |
11001099
| (bundled with CLI) | Built-in | Skills shipped with the CLI. Lowest priority—overridable by any other source. |
@@ -1135,7 +1134,7 @@ Custom agents are specialized AI agents defined in Markdown files. The filename
11351134
| Scope | Location |
11361135
|-------|----------|
11371136
| Project | `.github/agents/` or `.claude/agents/` |
1138-
| User | `~/.copilot/agents/` or `~/.claude/agents/` |
1137+
| User | `~/.copilot/agents/` |
11391138
| Plugin | `<plugin>/agents/` |
11401139

11411140
Project-level agents take precedence over user-level agents. Plugin agents have the lowest priority.

content/copilot/reference/copilot-cli-reference/cli-plugin-reference.md

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -178,11 +178,10 @@ The following diagram illustrates the loading order and precedence rules.
178178
│ 1. ~/.copilot/agents/ (user, .github convention) │
179179
│ 2. <project>/.github/agents/ (project) │
180180
│ 3. <parents>/.github/agents/ (inherited, monorepo) │
181-
│ 4. ~/.claude/agents/ (user, .claude convention) │
182-
│ 5. <project>/.claude/agents/ (project) │
183-
│ 6. <parents>/.claude/agents/ (inherited, monorepo) │
184-
│ 7. PLUGIN: agents/ dirs (plugin, by install order) │
185-
│ 8. Remote org/enterprise agents (remote, via API) │
181+
│ 4. <project>/.claude/agents/ (project) │
182+
│ 5. <parents>/.claude/agents/ (inherited, monorepo) │
183+
│ 6. PLUGIN: agents/ dirs (plugin, by install order) │
184+
│ 7. Remote org/enterprise agents (remote, via API) │
186185
└──────────────────────┬──────────────────────────────────────────────┘
187186
188187
┌──────────────────────▼──────────────────────────────────────────────┐
@@ -193,9 +192,8 @@ The following diagram illustrates the loading order and precedence rules.
193192
│ 4. <parents>/.github/skills/ etc. (inherited) │
194193
│ 5. ~/.copilot/skills/ (personal-copilot) │
195194
│ 6. ~/.agents/skills/ (personal-agents) │
196-
│ 7. ~/.claude/skills/ (personal-claude) │
197-
│ 8. PLUGIN: skills/ dirs (plugin) │
198-
│ 9. COPILOT_SKILLS_DIRS env + config (custom) │
195+
│ 7. PLUGIN: skills/ dirs (plugin) │
196+
│ 8. COPILOT_SKILLS_DIRS env + config (custom) │
199197
│ --- then commands (.claude/commands/), skills override commands ---│
200198
└──────────────────────┬──────────────────────────────────────────────┘
201199

content/copilot/reference/customization-cheat-sheet.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ This table shows what each customization feature is and where it lives.
2121
| [Prompt files](/copilot/concepts/prompting/response-customization?tool=vscode#about-prompt-files) | Reusable, standalone prompt template with input variables | `.github/prompts/*.prompt.md` |
2222
| [{% data variables.copilot.custom_agents_caps_short %}](/copilot/concepts/agents/cloud-agent/about-custom-agents) | Specialist persona with its own instructions, tool restrictions, and context | `.github/agents/AGENT-NAME.md` (repo), `agents/AGENT-NAME.md` in `.github-private` repo (org/enterprise), or user profile |
2323
| [{% data variables.copilot.subagents_caps_short %}](/copilot/how-tos/chat-with-copilot/chat-in-ide#using-subagents) | Separate agent spawned by the main agent to handle delegated work in an isolated context | N/A (runtime process, not a user-configured file) |
24-
| [Agent skills](/copilot/concepts/agents/about-agent-skills) | Folder of instructions, scripts, and resources that {% data variables.product.prodname_copilot_short %} loads when relevant to a task | `.github/skills/<skill-name>/SKILL.md`, `.claude/skills/<skill-name>/SKILL.md`, or `.agents/skills/<skill-name>/SKILL.md` (project); `~/.copilot/skills/<skill-name>/SKILL.md`, `~/.claude/skills/<skill-name>/SKILL.md`, or `~/.agents/skills/<skill-name>/SKILL.md` (personal) |
24+
| [Agent skills](/copilot/concepts/agents/about-agent-skills) | Folder of instructions, scripts, and resources that {% data variables.product.prodname_copilot_short %} loads when relevant to a task | `.github/skills/<skill-name>/SKILL.md`, `.claude/skills/<skill-name>/SKILL.md`, or `.agents/skills/<skill-name>/SKILL.md` (project); `~/.copilot/skills/<skill-name>/SKILL.md` or `~/.agents/skills/<skill-name>/SKILL.md` (personal) |
2525
| [Hooks](/copilot/concepts/agents/cloud-agent/about-hooks) | Custom shell commands that execute deterministically at specific points in an agent's workflow | `.github/hooks/*.json` |
2626
| [MCP servers](/copilot/concepts/context/mcp) | Connection to external systems, APIs, and databases | `mcp.json` (path varies by IDE), repo settings on {% data variables.product.github %} ({% data variables.copilot.copilot_cloud_agent_short %}), or `mcp-servers` property in {% data variables.copilot.copilot_custom_agent_short %} configurations |
2727

data/reusables/copilot/creating-adding-skills.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ To create an agent skill, you write a `SKILL.md` file and, optionally, other res
66

77
For **project skills**, specific to a single repository, create a `.github/skills`, `.claude/skills`, or `.agents/skills` directory in your repository.
88

9-
For **personal skills**, shared across projects, create a `~/.copilot/skills`, `~/.claude/skills`, or `~/.agents/skills` directory in your local home directory.
9+
For **personal skills**, shared across projects, create a `~/.copilot/skills` or `~/.agents/skills` directory in your local home directory.
1010

1111
1. Within the `skills` directory, create a subdirectory for your new skill. Each skill should have its own directory (for example, `.github/skills/webapp-testing`).
1212

@@ -101,4 +101,4 @@ In addition to creating your own skills, you can also add skills that other peop
101101

102102
* For **project skills**, specific to a single repository: `.github/skills`, `.claude/skills`, or `.agents/skills` in your repository.
103103

104-
* For **personal skills**, shared across projects: `~/.copilot/skills`, `~/.claude/skills`, or `~/.agents/skills` in your local home directory.
104+
* For **personal skills**, shared across projects: `~/.copilot/skills` or `~/.agents/skills` in your local home directory.

0 commit comments

Comments
 (0)