Add provider skill discovery and composer picker

[lintowe]

Summary

• Adds provider skill discovery and picker support to the composer

What Changed

• Discovers user/project skills for supported provider integrations
• Adds provider skills to the composer command menu and renders selected skills as inline chips
• Allows typing / to find matching provider skills alongside commands
• Filters app/plugin-backed skills out of the picker for now, so only regular installed skills are surfaced

Screenshots

Testing

• bun fmt
• bun lint
• bun typecheck
• bun run test src/provider/Layers/CodexProvider.test.ts from apps/server

---

Note

Medium Risk
Introduces filesystem-based skill discovery and threads the resulting skills/invocation behavior through provider status probes and the chat composer UI, which could affect provider snapshots and command insertion behavior across multiple integrations.

Overview
Adds cross-provider skill discovery by scanning SKILL.md files in user/project roots (new SkillDiscovery.ts), parsing frontmatter metadata, deduping, and assigning provider-specific invocation prefixes (/ vs $).

Extends provider status snapshots to include discovered skills: Claude now discovers skills (using configured HOME/cwd) and also merges enabled skills into slashCommands when no native command exists; OpenCode adds discovered skills using HOME/USERPROFILE; Codex filters out app/plugin-backed skills and fast-fails with a clear error when the CLI is missing.

Updates the web composer command menu to show skills alongside slash commands (with separate grouping), avoid duplicates between skills and provider slash commands, and insert the correct invocation prefix via formatProviderSkillInvocation; contracts add optional ServerProviderSkill.invocationPrefix while remaining backward compatible. Tests were added/updated across server, web, and contracts to cover parsing, discovery, filtering, and invocation formatting.

^{Reviewed by Cursor Bugbot for commit a2d4e78. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add provider skill discovery and composer picker with provider-specific invocation prefixes

• Adds SkillDiscovery.ts with utilities to scan SKILL.md files from project and user roots for Claude (.claude/skills), OpenCode, and common agent directories, parsing frontmatter and assigning invocation prefixes (/ or $) per provider.
• Extends checkClaudeProviderStatus and checkOpenCodeProviderStatus to include discovered skills in the ServerProviderDraft snapshot, merging them with native slash commands (native commands take precedence on name collision).
• Updates ChatComposer to display provider skills alongside slash commands in the command palette, grouped in a separate 'Skills' section, and inserts the correct invocation prefix via formatProviderSkillInvocation.
• Adds invocationPrefix ('$' or '/') as an optional field to the ServerProviderSkill contract schema.
• Filters Codex app-backed plugin skills (under .codex/plugins or .agents/plugins) from the skills list, and adds a fast-fail guard when the Codex CLI binary is missing from PATH.

^{Macroscope summarized a2d4e78.}

[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: 5e624349-9351-475a-a515-4b14578db11c

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

---

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.}

[macroscopeapp]

Approvability

Verdict: Needs human review

This PR introduces a new skill discovery system that scans for SKILL.md files across project and user directories, integrates discovered skills into three providers (Claude, Codex, OpenCode), and surfaces them in the composer UI. The scope—new modules, new workflows, contract changes, and cross-provider integration—warrants human review.

^{You can customize Macroscope's approvability policy. Learn more.}