feat (suggestion): add shared skills settings

[JustYannicc]

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:

After:

New Skills Setting Screen

Single Skill clicked in

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 settings panel with lifecycle management via WebSocket API

• Adds a new SkillsSettingsPanel component under a new "Skills" tab in the settings page, reachable via ?tab=skills in the URL.
• Introduces sharedSkills.ts on the server with functions to discover, migrate, enable/disable, and uninstall skills across Codex and Agents harness directories using a shared directory with symlinks.
• Exposes five new WebSocket RPC methods (getSharedSkills, getSharedSkillDetail, initializeSharedSkills, setSharedSkillEnabled, uninstallSharedSkill) backed by corresponding React Query hooks in sharedSkillsReactQuery.ts.
• Adds sharedSkillsPath to AppSettingsSchema with an empty-string default, allowing users to configure the shared skills directory via folder picker in the UI.
• Adds Effect/Schema types and IPC contracts in packages/contracts for all shared skill operations.

📊 Macroscope summarized a78c30d. 12 files reviewed, 3 issues evaluated, 0 issues filtered, 3 comments posted

🗂️ Filtered Issues

[coderabbitai]

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: 4e3910a3-aaf4-484b-9dc6-0f7a129f296d

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

• X
• Mastodon
• Reddit
• LinkedIn

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

Tip

CodeRabbit can use OpenGrep to find security vulnerabilities and bugs across 17+ programming languages.

OpenGrep is compatible with Semgrep configurations. Add an opengrep.yml or semgrep.yml configuration file to your project to enable OpenGrep analysis.