Skip to content

feat (suggestion): add shared skills settings#1085

Closed
JustYannicc wants to merge 3 commits intopingdotgg:mainfrom
JustYannicc:codex/issue-1081-shared-skills
Closed

feat (suggestion): add shared skills settings#1085
JustYannicc wants to merge 3 commits intopingdotgg:mainfrom
JustYannicc:codex/issue-1081-shared-skills

Conversation

@JustYannicc
Copy link

@JustYannicc JustYannicc commented Mar 14, 2026

What Changed

Implements shared skill management #1081.

This adds a Skills section in Settings, similar to Codex, where shared skills can be initialized and managed. On first use, skills are moved into a user-defined shared directory and symlinked back into the harness skill roots so Codex can keep working as usual without needing to know anything about the shared setup.

The PR also adds:

  • first-run initialization flow
  • shared skill discovery across the current Codex roots
  • enable / disable / uninstall actions
  • recheck + explicit move flow for newly discovered skills after initialization
  • backend + websocket plumbing and tests for the shared-skills flow

Why

The goal is to make local skills more portable across harnesses while keeping Codex behavior unchanged.

I mainly built this for myself so I can keep skills in one shared location and eventually reuse the same setup across tools like Codex and Claude Code. From Codex’s perspective, it should still just see normal skill directories in the places it already expects, because the shared setup is handled through symlinks.

This is tied to #1081, but there is no expectation that this has to be merged. I’m opening it in case the implementation is useful, and I’m completely fine if you decide not to take it.

If there are any changes I have to make, let me know.

UI Changes

Settings Screen

Before:
Screenshot 2026-03-14 at 17 23 23

After:

Screenshot 2026-03-14 at 18 39 40

New Skills Setting Screen

Screenshot 2026-03-14 at 18 46 02 Screenshot 2026-03-14 at 18 41 43

Single Skill clicked in

Screenshot 2026-03-14 at 18 43 31

Checklist

  • This PR is small and focused
  • I explained what changed and why
  • I included before/after screenshots for any UI changes
  • I included a video for animation/interaction changes

Note

Add shared skills management panel to settings

  • Adds a new Skills tab to the settings page, toggled via ?tab=skills URL search param, rendering a new SkillsSettingsPanel component.
  • Introduces sharedSkills.ts on the server, implementing full lifecycle management: scanning, migrating, symlinking, enabling/disabling, and uninstalling skills shared across Codex and ~/.agents/skills.
  • Exposes five new WebSocket RPC methods (getSharedSkills, getSharedSkillDetail, initializeSharedSkills, setSharedSkillEnabled, uninstallSharedSkill) wired through contracts, the WS server, and the web API client.
  • Adds React Query options and mutations in sharedSkillsReactQuery.ts to fetch state, initialize, toggle, and uninstall skills with automatic cache invalidation.
  • Risk: initialization migrates existing Codex user skills to a shared directory and replaces them with symlinks — this is a destructive, one-way filesystem operation.

Macroscope summarized f7a3870.

@coderabbitai
Copy link

coderabbitai bot commented Mar 14, 2026

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 81a868b8-264f-4253-a976-f90068409da2

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
📝 Coding Plan
  • Generate coding plan for human review comments

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Tip

You can customize the tone of the review comments and chat replies.

Configure the tone_instructions setting to customize the tone of the review comments and chat replies. For example, you can set the tone to Act like a strict teacher, Act like a pirate and more.

@github-actions github-actions bot added size:XXL 1,000+ changed lines (additions + deletions). vouch:unvouched PR author is not yet trusted in the VOUCHED list. labels Mar 14, 2026
@JustYannicc JustYannicc force-pushed the codex/issue-1081-shared-skills branch from a78c30d to 1120ea8 Compare March 15, 2026 18:39
@maria-rcks
Copy link
Collaborator

out of scope / big, closing sorry.
@juliusmarminge ping for the concept / idea

@maria-rcks maria-rcks closed this Mar 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:XXL 1,000+ changed lines (additions + deletions). vouch:unvouched PR author is not yet trusted in the VOUCHED list.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants