You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit f83a7ec
Browse filesBrowse the repository at this point in the historyBrowse files
fix: drop copilot per-scope path override, use .agents/skills both ways
The user-scope copilot install was landing at ~/.copilot/skills/, but
the bundled x-x skill content (agents/skills/x-plan/SKILL.md and
agents/skills/x-x/SKILL.md) defines `<skills_root>` as only
`.claude/skills/` (Claude Code) or `.agents/skills/` (other agents).
The agent's path-resolution logic globs that exact list and never
searches `~/.copilot/skills/`, so sibling files like
`_x-x_shared/_plan_first.md` were undiscoverable at user scope.
`~/.agents/skills/` is on Copilot CLI's official user-scope list
alongside `~/.copilot/skills/` (docs.github.com/en/copilot/how-tos/
copilot-cli/customize-copilot/add-skills), so reusing the cross-agent
open spec path at user scope is conformant — and it lets the bundled
skill content work unchanged.
agentTarget.userSkillsRel stays on the struct for future agents whose
project- vs user-scope paths genuinely diverge; copilot doesn't need
it anymore.
Cleanup:
- constants.go: copilot row's userSkillsRel back to empty.
- scripts/e2e_test.sh + ps1: drop COPILOT_USER_SKILLS_REL constant,
update the user-scope copilot e2e case to assert on `~/.agents/skills`.
- docs/public/reference.md + getting-started.md: prose updated.
Signed-off-by: Tanzim Saqib <[email protected]>
Copy file name to clipboardExpand all lines: docs/public/reference.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,7 +27,7 @@ Installs every bundled skill into the locations each agent looks for, then seeds
27
27
1.**Which agents?** Multi-select over every registered agent (Claude Code, Codex CLI, GitHub Copilot CLI today). Blank line / no toggle accepts the default (all agents).
28
28
2.**Which scope?**
29
29
-**This project only** — writes under the current working directory (`.claude/skills/`, `.agents/skills/` shared by Codex and Copilot, and seeds `.x-plans/`).
30
-
-**All my projects (user scope)** — writes under `$HOME` (`~/.claude/skills/`, `~/.agents/skills/` for Codex, `~/.copilot/skills/` for Copilot CLI).
30
+
-**All my projects (user scope)** — writes under `$HOME` (`~/.claude/skills/`, `~/.agents/skills/` for Codex and Copilot CLI).
31
31
3.**Prefix width for plan files** — zero-padded width for plan filenames (e.g. width `4` → `0001-foo.md`). Default: `4`.
32
32
4.**Maximum lines per plan** — cap enforced by `x-x plans lint`. Keeps AI agents on a short leash: forces them to split sprawling work into smaller, reviewable plans. Default: `30`.
33
33
5.**Pause for review after every…** — `task` reviews each EARS criterion as the planner finishes it (tight loop, more interruptions); `plan` reviews only at plan boundaries (looser loop, larger diffs). Default: `task`.
@@ -42,15 +42,15 @@ Every prompt has a non-interactive flag twin — pass any subset to skip the mat
42
42
43
43
Values 3–5 land in `.x-plans/_config.lock` and become the lock-file pins for the project — re-running `x-x init` later does NOT refresh them (Cargo.lock / package-lock.json semantics). Never manually edit `.x-plans/_config.lock`.
44
44
45
-
Codex CLI reads from `.agents/skills` at every level (cwd, repo root, and `$HOME`), per the cross-agent SKILL.md open standard. GitHub Copilot CLI also reads `.agents/skills` at project scope (so the project-scope install populates one directory that both Codex and Copilot CLI pick up), but its user-scope path is `~/.copilot/skills/`— the Copilot-native location documented at [docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-skills](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-skills). On Windows, `~` resolves to `%USERPROFILE%`, so `~/.claude/skills/` is `%USERPROFILE%\.claude\skills\`, `~/.agents/skills/` is `%USERPROFILE%\.agents\skills\`, `~/.copilot/skills/` is `%USERPROFILE%\.copilot\skills\`, and so on. Inside WSL2, paths resolve against the WSL home (`/home/<user>/...`) — install x-x with `INSTALL.sh` from inside WSL to land in the WSL filesystem.
45
+
Codex CLI reads from `.agents/skills` at every level (cwd, repo root, and `$HOME`), per the cross-agent SKILL.md open standard. GitHub Copilot CLI also reads `.agents/skills` at both projectand userscope — `~/.agents/skills/`is on Copilot CLI's [official user-scope list](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-skills) alongside `~/.copilot/skills/`, and we land in the cross-agent path so the bundled `SKILL.md` content (which documents only `.claude/skills` and `.agents/skills`) discovers shared docs correctly. On Windows, `~` resolves to `%USERPROFILE%`, so `~/.claude/skills/` is `%USERPROFILE%\.claude\skills\`, `~/.agents/skills/` is `%USERPROFILE%\.agents\skills\`, and so on. Inside WSL2, paths resolve against the WSL home (`/home/<user>/...`) — install x-x with `INSTALL.sh` from inside WSL to land in the WSL filesystem.
46
46
47
47
On macOS and Linux at user scope, skill directories are installed as symlinks into `~/.x-x/agents/skills/`, so refreshes to the bundled tree propagate to every project at once. On Windows (and at project scope everywhere), skills are copied. Re-running `x-x init` always overwrites the bundled skill directories with the current release — they are repo-shipped content, not user state.
48
48
49
49
Agent-specific config files (e.g. `~/.claude/settings.json`) are seeded only when absent — existing files are left alone.
50
50
51
51
### `x-x skills remove --user`
52
52
53
-
Walks `~/.claude/skills/`, `~/.agents/skills/`, `~/.copilot/skills/`, etc., and removes every entry whose name matches the bundled-skill allowlist (`_x-x_shared`, `x-plan`, `x-x` today). The name is the only criterion — symlink targets are not consulted, which means an entry named the same as a bundled skill *will* be removed even if you authored it yourself. Rename any local skill that collides with a bundled one before running this command.
53
+
Walks `~/.claude/skills/`, `~/.agents/skills/`, etc., and removes every entry whose name matches the bundled-skill allowlist (`_x-x_shared`, `x-plan`, `x-x` today). The name is the only criterion — symlink targets are not consulted, which means an entry named the same as a bundled skill *will* be removed even if you authored it yourself. Rename any local skill that collides with a bundled one before running this command.
54
54
55
55
In addition to deleting bundled skill directories, `skill remove` un-merges the hook records `x-x init` previously deep-merged into each agent's JSON config (`~/.claude/settings.json`, `~/.codex/hooks.json`). Subtraction is per-record and uses deep-equality against the currently bundled file under `~/.x-x/agents/<agent>/`: a record that byte-equals one of ours is dropped; a user-tweaked variant (different command, different matcher) is preserved. The file, its top-level non-hook keys, user-added event keys, and any user-authored sibling entries under the same event key all stay.
56
56
@@ -59,7 +59,7 @@ The following are never touched:
59
59
- Folders whose name is not on the bundled-skill allowlist (your own skills sitting alongside ours).
60
60
- Anything in the agent config files outside of their `"hooks"` subtree — top-level keys like `"fastMode"` and any user-authored content. Empty arrays or event-key maps left behind by the un-merge are kept as-is; we subtract records, not containers.
61
61
- The `.x-plans/` scaffold at project scope. Once `init` writes it, it's yours.
62
-
- Parent directories (`.claude/`, `.codex/`, `.copilot/`). Only the `skills/` subdirectory under each may be removed, and only when it is empty after cleanup.
62
+
- Parent directories (`.claude/`, `.codex/`). Only the `skills/` subdirectory under each may be removed, and only when it is empty after cleanup.
0 commit comments