Skip to content

move agent skills to repo root for tool discoverability#8535

Merged
morgmart merged 1 commit intomainfrom
move-agent-skills-to-root
Apr 14, 2026
Merged

move agent skills to repo root for tool discoverability#8535
morgmart merged 1 commit intomainfrom
move-agent-skills-to-root

Conversation

@morgmart
Copy link
Copy Markdown
Collaborator

@morgmart morgmart commented Apr 14, 2026

Category: infrastructure
User Impact: Agent skills (code-review, create-pr, edge-case-finder, create-app-e2e-test) are now discoverable by Cursor, Claude Code, and Codex from the workspace root.

Problem: After the goose2 repo was merged into goose, the agent skills ended up nested under ui/goose2/, which is too deep for Cursor, Claude Code, and Codex to discover at the workspace level. Contributors using these tools couldn't access the shared skills.

Solution: Moved the canonical skill files to .agents/skills/ at the repo root and added symlinks for each tool's expected directory (.cursor/skills/, .claude/skills/, .codex/skills/). Replaced the blanket .claude gitignore with a targeted ignore for .claude/settings.local.json so that shared skills are tracked while personal Claude Code config stays local.

File changes

.agents/skills/code-review/SKILL.md
Moved from ui/goose2/.agents/skills/ — no content changes.

.agents/skills/create-app-e2e-test/SKILL.md
Moved from ui/goose2/.agents/skills/ — no content changes.

.agents/skills/create-pr/SKILL.md
Moved from ui/goose2/.agents/skills/ — no content changes.

.agents/skills/edge-case-finder/SKILL.md
Moved from ui/goose2/.agents/skills/ — no content changes.

.agents/skills/edge-case-finder/references/edge-case-categories.md
Moved from ui/goose2/.agents/skills/ — no content changes.

.cursor/skills/, .claude/skills/, .codex/skills/
Symlinks pointing to the canonical files in ../../.agents/skills/ for each of the four skills.

.gitignore
Replaced the blanket .claude ignore with .claude/settings.local.json so that .claude/skills/ is tracked normally while personal Claude Code config stays out of version control.

How to verify

  1. Clone the repo fresh or check out this branch.
  2. Verify .cursor/skills/code-review/SKILL.md resolves (e.g. cat .cursor/skills/code-review/SKILL.md).
  3. Verify the same for .claude/skills/ and .codex/skills/.
  4. Confirm ui/goose2/.agents/skills/ no longer exists.
  5. Confirm git add .claude/skills/new-skill works without -f.

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 68ef088164

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .gitignore Outdated
Skills were nested under ui/goose2/ after the repo merge, making them
invisible to Cursor, Claude Code, and Codex at the workspace level.
Move the canonical files to .agents/skills/ at the root and add
symlinks for each tool (.cursor/skills/, .claude/skills/, .codex/skills/).

Signed-off-by: morgmart <98432065+morgmart@users.noreply.github.com>
@morgmart morgmart force-pushed the move-agent-skills-to-root branch from 68ef088 to 7df8ae6 Compare April 14, 2026 19:54
@morgmart morgmart enabled auto-merge April 14, 2026 20:49
@morgmart morgmart added this pull request to the merge queue Apr 14, 2026
Merged via the queue into main with commit 529d6f7 Apr 14, 2026
23 checks passed
@morgmart morgmart deleted the move-agent-skills-to-root branch April 14, 2026 23:17
michaelneale added a commit that referenced this pull request Apr 15, 2026
…rning

* origin/main:
  move agent skills to repo root for tool discoverability (#8535)
  port goose2 chat attachments into goose (#8534)
  chore(release): bump version to 1.31.0 (minor) (#8527)
  feature: provider & model config (#8515)
  Move goose2 (#8516)
  feat: onboarding UX for the TUI (#8513)
  Set MACOSX_DEPLOYMENT_TARGET=12.0 in build-cli.yml (#8525)
  Improve local inference settings and model downloader (#8467)
  Add prompt injection mitigation logging back (#8518)
  feat(providers): add llama-swap declarative provider (#8462)
  fix: Unable to Run `goose update` on Linux (#8465)
  Add vision/image support for local inference models (#8442)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants