fix(web): match skill chip icons to file chips and add sent-message tooltips

[Mnigos]

Two small skill chip fixes that came out of testing workspace skill discovery. The skill icon now renders at the same optical size as file-chip icons (the package glyph fills its viewBox edge to edge, file-type icons carry intrinsic padding). And sent-message chips get the description tooltip the composer already had, with the InlineSkill prop type carrying the description fields through MessagesTimeline and ChatMarkdown, which previously narrowed them away.

Also documents the workspace-scoped skill behavior that #8778 and #9210 shipped in docs/user/composer.md, since neither added docs.

Earlier revisions of this PR carried the workspace discovery itself; that landed piecewise through #8778 by @UtkarshUsername and #9210 by @anirudhsama (based on the approach from #4031 by @D3OXY), so this PR is down to the chip polish. Chip rendering has 7 focused tests.

Demo

Screen.Recording.2026-09-02.at.00.57.59.mov

Screenshots

Implemented with Claude Code (Claude Fable 5).

---

Note

Medium Risk
New RPC spawns Codex app-server processes per workspace lookup (mitigated by timeout and cache); cwd resolution touches orchestration projection data but stays read-only with ownership checks.

Overview
Fixes the $ skill picker and sent-message $name chips using skills from the open project/worktree instead of the server’s startup directory.

Adds provider.listWorkspaceSkills (read-scoped RPC) with contracts for input/result/source: workspace | snapshot. The server resolves cwd from thread.worktreePath ?? project.workspaceRoot, validates thread ownership, and calls an optional listSkillsForCwd on provider instances—with a 30s TTL cache per (instanceId, cwd) that does not mutate provider snapshots. Codex spawns a short-lived app-server in the workspace and calls skills/list; Claude uses discoverClaudeSkills for the resolved cwd; other drivers return source: "snapshot" so clients keep snapshot skills.

On the web, useWorkspaceSkills fetches the workspace catalog for the composer ($ menu, slash skills) and the timeline so chips survive sending. Skill chip UI is aligned (shared wrapper class, smaller skill icon) and timeline chips get description tooltips like the composer.

^{Reviewed by Cursor Bugbot for commit 26e4a23f392d6c6c72e285dbb3fd001aee61177a. Configure here.}

Note

Fix skill chip icon styling and add description tooltips to sent message skill chips

• Updates SkillChip to use the shared INLINE_CHIP_WRAPPER_CLASS_NAME and dedicated SKILL_CHIP_ICON_CLASS_NAME so sent-message skill chips match file chip styling
• Adds a top-positioned tooltip to skill chips when a description is available, resolving via resolveInlineSkillDescription which prefers trimmed shortDescription over description- Refactors skill shape to the shared exported InlineSkill type across ChatMarkdown, MessagesTimeline, and SkillInlineText to carry description fields
• Updates ComposerSkillDecorator to use SKILL_CHIP_ICON_CLASS_NAME for icon sizing
• Documents composer skill discovery behavior for Codex, Claude, and OpenCode in composer.md

^{Macroscope summarized dab755e.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit 26e4a23. Configure here.}

[macroscopeapp]

Approvability

Verdict: Approved at dab755e

Macroscope's review found this PR approvable — This is a narrowly scoped web UI polish change that aligns existing skill chips and adds optional descriptions through the existing tooltip component. Its runtime impact is limited to presentation and hover behavior, with focused tests and no schema, workflow, deployment, or sensitive-data changes.

^{You can add or adjust custom eligibility rules. Learn more.}

Dismissing prior approval to re-evaluate 01313dd

Dismissing prior approval to re-evaluate dab755e

[Mnigos]

Two small skill chip fixes that came out of testing workspace skill discovery. The skill icon now renders at the same optical size as file-chip icons (the package glyph fills its viewBox edge to edge, file-type icons carry intrinsic padding). And sent-message chips get the description tooltip the composer already had, with the InlineSkill prop type carrying the description fields through MessagesTimeline and ChatMarkdown, which previously narrowed them away.

Also documents the workspace-scoped skill behavior that #8778 and #9210 shipped in docs/user/composer.md, since neither added docs.

Earlier revisions of this PR carried the workspace discovery itself; that landed piecewise through #8778 by @UtkarshUsername and #9210 by @anirudhsama (based on the approach from #4031 by @D3OXY), so this PR is down to the chip polish. Chip rendering has 7 focused tests.

Demo

Screen.Recording.2026-09-02.at.00.57.59.mov

Screenshots

Implemented with Claude Code (Claude Fable 5).

---

Note

Medium Risk
New RPC spawns Codex app-server processes per workspace lookup (mitigated by timeout and cache); cwd resolution touches orchestration projection data but stays read-only with ownership checks.

Overview
Fixes the $ skill picker and sent-message $name chips using skills from the open project/worktree instead of the server’s startup directory.

Adds provider.listWorkspaceSkills (read-scoped RPC) with contracts for input/result/source: workspace | snapshot. The server resolves cwd from thread.worktreePath ?? project.workspaceRoot, validates thread ownership, and calls an optional listSkillsForCwd on provider instances—with a 30s TTL cache per (instanceId, cwd) that does not mutate provider snapshots. Codex spawns a short-lived app-server in the workspace and calls skills/list; Claude uses discoverClaudeSkills for the resolved cwd; other drivers return source: "snapshot" so clients keep snapshot skills.

On the web, useWorkspaceSkills fetches the workspace catalog for the composer ($ menu, slash skills) and the timeline so chips survive sending. Skill chip UI is aligned (shared wrapper class, smaller skill icon) and timeline chips get description tooltips like the composer.

^{Reviewed by Cursor Bugbot for commit 26e4a23f392d6c6c72e285dbb3fd001aee61177a. Configure here.}

Note

Fix skill chip icon styling and add description tooltips to sent message skill chips

• Updates SkillChip to use the shared INLINE_CHIP_WRAPPER_CLASS_NAME and dedicated SKILL_CHIP_ICON_CLASS_NAME so sent-message skill chips match file chip styling
• Adds a top-positioned tooltip to skill chips when a description is available, resolving via resolveInlineSkillDescription which prefers trimmed shortDescription over description- Refactors skill shape to the shared exported InlineSkill type across ChatMarkdown, MessagesTimeline, and SkillInlineText to carry description fields
• Updates ComposerSkillDecorator to use SKILL_CHIP_ICON_CLASS_NAME for icon sizing
• Documents composer skill discovery behavior for Codex, Claude, and OpenCode in composer.md

^{Macroscope summarized dab755e.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit 26e4a23. Configure here.}

[macroscopeapp]

Approvability

Verdict: Approved at dab755e

Macroscope's review found this PR approvable — This is a narrowly scoped web UI polish change that aligns existing skill chips and adds optional descriptions through the existing tooltip component. Its runtime impact is limited to presentation and hover behavior, with focused tests and no schema, workflow, deployment, or sensitive-data changes.

^{You can add or adjust custom eligibility rules. Learn more.}

Dismissing prior approval to re-evaluate 01313dd

Dismissing prior approval to re-evaluate dab755e

[Mnigos]

Two small skill chip fixes that came out of testing workspace skill discovery. The skill icon now renders at the same optical size as file-chip icons (the package glyph fills its viewBox edge to edge, file-type icons carry intrinsic padding). And sent-message chips get the description tooltip the composer already had, with the InlineSkill prop type carrying the description fields through MessagesTimeline and ChatMarkdown, which previously narrowed them away.

Also documents the workspace-scoped skill behavior that #8778 and #9210 shipped in docs/user/composer.md, since neither added docs.

Earlier revisions of this PR carried the workspace discovery itself; that landed piecewise through #8778 by @UtkarshUsername and #9210 by @anirudhsama (based on the approach from #4031 by @D3OXY), so this PR is down to the chip polish. Chip rendering has 7 focused tests.

Demo

Screen.Recording.2026-09-02.at.00.57.59.mov

Screenshots

Implemented with Claude Code (Claude Fable 5).

---

Note

Medium Risk
New RPC spawns Codex app-server processes per workspace lookup (mitigated by timeout and cache); cwd resolution touches orchestration projection data but stays read-only with ownership checks.

Overview
Fixes the $ skill picker and sent-message $name chips using skills from the open project/worktree instead of the server’s startup directory.

Adds provider.listWorkspaceSkills (read-scoped RPC) with contracts for input/result/source: workspace | snapshot. The server resolves cwd from thread.worktreePath ?? project.workspaceRoot, validates thread ownership, and calls an optional listSkillsForCwd on provider instances—with a 30s TTL cache per (instanceId, cwd) that does not mutate provider snapshots. Codex spawns a short-lived app-server in the workspace and calls skills/list; Claude uses discoverClaudeSkills for the resolved cwd; other drivers return source: "snapshot" so clients keep snapshot skills.

On the web, useWorkspaceSkills fetches the workspace catalog for the composer ($ menu, slash skills) and the timeline so chips survive sending. Skill chip UI is aligned (shared wrapper class, smaller skill icon) and timeline chips get description tooltips like the composer.

^{Reviewed by Cursor Bugbot for commit 26e4a23f392d6c6c72e285dbb3fd001aee61177a. Configure here.}

Note

Fix skill chip icon styling and add description tooltips to sent message skill chips

• Updates SkillChip to use the shared INLINE_CHIP_WRAPPER_CLASS_NAME and dedicated SKILL_CHIP_ICON_CLASS_NAME so sent-message skill chips match file chip styling
• Adds a top-positioned tooltip to skill chips when a description is available, resolving via resolveInlineSkillDescription which prefers trimmed shortDescription over description- Refactors skill shape to the shared exported InlineSkill type across ChatMarkdown, MessagesTimeline, and SkillInlineText to carry description fields
• Updates ComposerSkillDecorator to use SKILL_CHIP_ICON_CLASS_NAME for icon sizing
• Documents composer skill discovery behavior for Codex, Claude, and OpenCode in composer.md

^{Macroscope summarized dab755e.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit 26e4a23. Configure here.}

[macroscopeapp]

Approvability

Verdict: Approved at dab755e

Macroscope's review found this PR approvable — This is a narrowly scoped web UI polish change that aligns existing skill chips and adds optional descriptions through the existing tooltip component. Its runtime impact is limited to presentation and hover behavior, with focused tests and no schema, workflow, deployment, or sensitive-data changes.

^{You can add or adjust custom eligibility rules. Learn more.}

Dismissing prior approval to re-evaluate 01313dd

Dismissing prior approval to re-evaluate dab755e

[Mnigos]

Two small skill chip fixes that came out of testing workspace skill discovery. The skill icon now renders at the same optical size as file-chip icons (the package glyph fills its viewBox edge to edge, file-type icons carry intrinsic padding). And sent-message chips get the description tooltip the composer already had, with the InlineSkill prop type carrying the description fields through MessagesTimeline and ChatMarkdown, which previously narrowed them away.

Also documents the workspace-scoped skill behavior that #8778 and #9210 shipped in docs/user/composer.md, since neither added docs.

Earlier revisions of this PR carried the workspace discovery itself; that landed piecewise through #8778 by @UtkarshUsername and #9210 by @anirudhsama (based on the approach from #4031 by @D3OXY), so this PR is down to the chip polish. Chip rendering has 7 focused tests.

Demo

Screen.Recording.2026-09-02.at.00.57.59.mov

Screenshots

Implemented with Claude Code (Claude Fable 5).

---

Note

Medium Risk
New RPC spawns Codex app-server processes per workspace lookup (mitigated by timeout and cache); cwd resolution touches orchestration projection data but stays read-only with ownership checks.

Overview
Fixes the $ skill picker and sent-message $name chips using skills from the open project/worktree instead of the server’s startup directory.

Adds provider.listWorkspaceSkills (read-scoped RPC) with contracts for input/result/source: workspace | snapshot. The server resolves cwd from thread.worktreePath ?? project.workspaceRoot, validates thread ownership, and calls an optional listSkillsForCwd on provider instances—with a 30s TTL cache per (instanceId, cwd) that does not mutate provider snapshots. Codex spawns a short-lived app-server in the workspace and calls skills/list; Claude uses discoverClaudeSkills for the resolved cwd; other drivers return source: "snapshot" so clients keep snapshot skills.

On the web, useWorkspaceSkills fetches the workspace catalog for the composer ($ menu, slash skills) and the timeline so chips survive sending. Skill chip UI is aligned (shared wrapper class, smaller skill icon) and timeline chips get description tooltips like the composer.

^{Reviewed by Cursor Bugbot for commit 26e4a23f392d6c6c72e285dbb3fd001aee61177a. Configure here.}

Note

Fix skill chip icon styling and add description tooltips to sent message skill chips

• Updates SkillChip to use the shared INLINE_CHIP_WRAPPER_CLASS_NAME and dedicated SKILL_CHIP_ICON_CLASS_NAME so sent-message skill chips match file chip styling
• Adds a top-positioned tooltip to skill chips when a description is available, resolving via resolveInlineSkillDescription which prefers trimmed shortDescription over description- Refactors skill shape to the shared exported InlineSkill type across ChatMarkdown, MessagesTimeline, and SkillInlineText to carry description fields
• Updates ComposerSkillDecorator to use SKILL_CHIP_ICON_CLASS_NAME for icon sizing
• Documents composer skill discovery behavior for Codex, Claude, and OpenCode in composer.md

^{Macroscope summarized dab755e.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit 26e4a23. Configure here.}

[macroscopeapp]

Approvability

Verdict: Approved at dab755e

Macroscope's review found this PR approvable — This is a narrowly scoped web UI polish change that aligns existing skill chips and adds optional descriptions through the existing tooltip component. Its runtime impact is limited to presentation and hover behavior, with focused tests and no schema, workflow, deployment, or sensitive-data changes.

^{You can add or adjust custom eligibility rules. Learn more.}

Dismissing prior approval to re-evaluate 01313dd

Dismissing prior approval to re-evaluate dab755e

[Mnigos]

Two small skill chip fixes that came out of testing workspace skill discovery. The skill icon now renders at the same optical size as file-chip icons (the package glyph fills its viewBox edge to edge, file-type icons carry intrinsic padding). And sent-message chips get the description tooltip the composer already had, with the InlineSkill prop type carrying the description fields through MessagesTimeline and ChatMarkdown, which previously narrowed them away.

Also documents the workspace-scoped skill behavior that #8778 and #9210 shipped in docs/user/composer.md, since neither added docs.

Earlier revisions of this PR carried the workspace discovery itself; that landed piecewise through #8778 by @UtkarshUsername and #9210 by @anirudhsama (based on the approach from #4031 by @D3OXY), so this PR is down to the chip polish. Chip rendering has 7 focused tests.

Demo

Screen.Recording.2026-09-02.at.00.57.59.mov

Screenshots

Implemented with Claude Code (Claude Fable 5).

---

Note

Medium Risk
New RPC spawns Codex app-server processes per workspace lookup (mitigated by timeout and cache); cwd resolution touches orchestration projection data but stays read-only with ownership checks.

Overview
Fixes the $ skill picker and sent-message $name chips using skills from the open project/worktree instead of the server’s startup directory.

Adds provider.listWorkspaceSkills (read-scoped RPC) with contracts for input/result/source: workspace | snapshot. The server resolves cwd from thread.worktreePath ?? project.workspaceRoot, validates thread ownership, and calls an optional listSkillsForCwd on provider instances—with a 30s TTL cache per (instanceId, cwd) that does not mutate provider snapshots. Codex spawns a short-lived app-server in the workspace and calls skills/list; Claude uses discoverClaudeSkills for the resolved cwd; other drivers return source: "snapshot" so clients keep snapshot skills.

On the web, useWorkspaceSkills fetches the workspace catalog for the composer ($ menu, slash skills) and the timeline so chips survive sending. Skill chip UI is aligned (shared wrapper class, smaller skill icon) and timeline chips get description tooltips like the composer.

^{Reviewed by Cursor Bugbot for commit 26e4a23f392d6c6c72e285dbb3fd001aee61177a. Configure here.}

Note

Fix skill chip icon styling and add description tooltips to sent message skill chips

• Updates SkillChip to use the shared INLINE_CHIP_WRAPPER_CLASS_NAME and dedicated SKILL_CHIP_ICON_CLASS_NAME so sent-message skill chips match file chip styling
• Adds a top-positioned tooltip to skill chips when a description is available, resolving via resolveInlineSkillDescription which prefers trimmed shortDescription over description- Refactors skill shape to the shared exported InlineSkill type across ChatMarkdown, MessagesTimeline, and SkillInlineText to carry description fields
• Updates ComposerSkillDecorator to use SKILL_CHIP_ICON_CLASS_NAME for icon sizing
• Documents composer skill discovery behavior for Codex, Claude, and OpenCode in composer.md

^{Macroscope summarized dab755e.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit 26e4a23. Configure here.}

[macroscopeapp]

Approvability

Verdict: Approved at dab755e

Macroscope's review found this PR approvable — This is a narrowly scoped web UI polish change that aligns existing skill chips and adds optional descriptions through the existing tooltip component. Its runtime impact is limited to presentation and hover behavior, with focused tests and no schema, workflow, deployment, or sensitive-data changes.

^{You can add or adjust custom eligibility rules. Learn more.}

Dismissing prior approval to re-evaluate 01313dd

Dismissing prior approval to re-evaluate dab755e

[Mnigos]

Two small skill chip fixes that came out of testing workspace skill discovery. The skill icon now renders at the same optical size as file-chip icons (the package glyph fills its viewBox edge to edge, file-type icons carry intrinsic padding). And sent-message chips get the description tooltip the composer already had, with the InlineSkill prop type carrying the description fields through MessagesTimeline and ChatMarkdown, which previously narrowed them away.

Also documents the workspace-scoped skill behavior that #8778 and #9210 shipped in docs/user/composer.md, since neither added docs.

Earlier revisions of this PR carried the workspace discovery itself; that landed piecewise through #8778 by @UtkarshUsername and #9210 by @anirudhsama (based on the approach from #4031 by @D3OXY), so this PR is down to the chip polish. Chip rendering has 7 focused tests.

Demo

Screen.Recording.2026-09-02.at.00.57.59.mov

Screenshots

Implemented with Claude Code (Claude Fable 5).

---

Note

Medium Risk
New RPC spawns Codex app-server processes per workspace lookup (mitigated by timeout and cache); cwd resolution touches orchestration projection data but stays read-only with ownership checks.

Overview
Fixes the $ skill picker and sent-message $name chips using skills from the open project/worktree instead of the server’s startup directory.

Adds provider.listWorkspaceSkills (read-scoped RPC) with contracts for input/result/source: workspace | snapshot. The server resolves cwd from thread.worktreePath ?? project.workspaceRoot, validates thread ownership, and calls an optional listSkillsForCwd on provider instances—with a 30s TTL cache per (instanceId, cwd) that does not mutate provider snapshots. Codex spawns a short-lived app-server in the workspace and calls skills/list; Claude uses discoverClaudeSkills for the resolved cwd; other drivers return source: "snapshot" so clients keep snapshot skills.

On the web, useWorkspaceSkills fetches the workspace catalog for the composer ($ menu, slash skills) and the timeline so chips survive sending. Skill chip UI is aligned (shared wrapper class, smaller skill icon) and timeline chips get description tooltips like the composer.

^{Reviewed by Cursor Bugbot for commit 26e4a23f392d6c6c72e285dbb3fd001aee61177a. Configure here.}

Note

Fix skill chip icon styling and add description tooltips to sent message skill chips

• Updates SkillChip to use the shared INLINE_CHIP_WRAPPER_CLASS_NAME and dedicated SKILL_CHIP_ICON_CLASS_NAME so sent-message skill chips match file chip styling
• Adds a top-positioned tooltip to skill chips when a description is available, resolving via resolveInlineSkillDescription which prefers trimmed shortDescription over description- Refactors skill shape to the shared exported InlineSkill type across ChatMarkdown, MessagesTimeline, and SkillInlineText to carry description fields
• Updates ComposerSkillDecorator to use SKILL_CHIP_ICON_CLASS_NAME for icon sizing
• Documents composer skill discovery behavior for Codex, Claude, and OpenCode in composer.md

^{Macroscope summarized dab755e.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit 26e4a23. Configure here.}

[macroscopeapp]

Approvability

Verdict: Approved at dab755e

Macroscope's review found this PR approvable — This is a narrowly scoped web UI polish change that aligns existing skill chips and adds optional descriptions through the existing tooltip component. Its runtime impact is limited to presentation and hover behavior, with focused tests and no schema, workflow, deployment, or sensitive-data changes.

^{You can add or adjust custom eligibility rules. Learn more.}

Dismissing prior approval to re-evaluate 01313dd

Dismissing prior approval to re-evaluate dab755e

[Mnigos]

Two small skill chip fixes that came out of testing workspace skill discovery. The skill icon now renders at the same optical size as file-chip icons (the package glyph fills its viewBox edge to edge, file-type icons carry intrinsic padding). And sent-message chips get the description tooltip the composer already had, with the InlineSkill prop type carrying the description fields through MessagesTimeline and ChatMarkdown, which previously narrowed them away.

Also documents the workspace-scoped skill behavior that #8778 and #9210 shipped in docs/user/composer.md, since neither added docs.

Earlier revisions of this PR carried the workspace discovery itself; that landed piecewise through #8778 by @UtkarshUsername and #9210 by @anirudhsama (based on the approach from #4031 by @D3OXY), so this PR is down to the chip polish. Chip rendering has 7 focused tests.

Demo

Screen.Recording.2026-09-02.at.00.57.59.mov

Screenshots

Implemented with Claude Code (Claude Fable 5).

---

Note

Medium Risk
New RPC spawns Codex app-server processes per workspace lookup (mitigated by timeout and cache); cwd resolution touches orchestration projection data but stays read-only with ownership checks.

Overview
Fixes the $ skill picker and sent-message $name chips using skills from the open project/worktree instead of the server’s startup directory.

Adds provider.listWorkspaceSkills (read-scoped RPC) with contracts for input/result/source: workspace | snapshot. The server resolves cwd from thread.worktreePath ?? project.workspaceRoot, validates thread ownership, and calls an optional listSkillsForCwd on provider instances—with a 30s TTL cache per (instanceId, cwd) that does not mutate provider snapshots. Codex spawns a short-lived app-server in the workspace and calls skills/list; Claude uses discoverClaudeSkills for the resolved cwd; other drivers return source: "snapshot" so clients keep snapshot skills.

On the web, useWorkspaceSkills fetches the workspace catalog for the composer ($ menu, slash skills) and the timeline so chips survive sending. Skill chip UI is aligned (shared wrapper class, smaller skill icon) and timeline chips get description tooltips like the composer.

^{Reviewed by Cursor Bugbot for commit 26e4a23f392d6c6c72e285dbb3fd001aee61177a. Configure here.}

Note

Fix skill chip icon styling and add description tooltips to sent message skill chips

• Updates SkillChip to use the shared INLINE_CHIP_WRAPPER_CLASS_NAME and dedicated SKILL_CHIP_ICON_CLASS_NAME so sent-message skill chips match file chip styling
• Adds a top-positioned tooltip to skill chips when a description is available, resolving via resolveInlineSkillDescription which prefers trimmed shortDescription over description- Refactors skill shape to the shared exported InlineSkill type across ChatMarkdown, MessagesTimeline, and SkillInlineText to carry description fields
• Updates ComposerSkillDecorator to use SKILL_CHIP_ICON_CLASS_NAME for icon sizing
• Documents composer skill discovery behavior for Codex, Claude, and OpenCode in composer.md

^{Macroscope summarized dab755e.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit 26e4a23. Configure here.}

[macroscopeapp]

Approvability

Verdict: Approved at dab755e

Macroscope's review found this PR approvable — This is a narrowly scoped web UI polish change that aligns existing skill chips and adds optional descriptions through the existing tooltip component. Its runtime impact is limited to presentation and hover behavior, with focused tests and no schema, workflow, deployment, or sensitive-data changes.

^{You can add or adjust custom eligibility rules. Learn more.}

Dismissing prior approval to re-evaluate 01313dd

Dismissing prior approval to re-evaluate dab755e

[Mnigos]

Two small skill chip fixes that came out of testing workspace skill discovery. The skill icon now renders at the same optical size as file-chip icons (the package glyph fills its viewBox edge to edge, file-type icons carry intrinsic padding). And sent-message chips get the description tooltip the composer already had, with the InlineSkill prop type carrying the description fields through MessagesTimeline and ChatMarkdown, which previously narrowed them away.

Also documents the workspace-scoped skill behavior that #8778 and #9210 shipped in docs/user/composer.md, since neither added docs.

Earlier revisions of this PR carried the workspace discovery itself; that landed piecewise through #8778 by @UtkarshUsername and #9210 by @anirudhsama (based on the approach from #4031 by @D3OXY), so this PR is down to the chip polish. Chip rendering has 7 focused tests.

Demo

Screen.Recording.2026-09-02.at.00.57.59.mov

Screenshots

Implemented with Claude Code (Claude Fable 5).

---

Note

Medium Risk
New RPC spawns Codex app-server processes per workspace lookup (mitigated by timeout and cache); cwd resolution touches orchestration projection data but stays read-only with ownership checks.

Overview
Fixes the $ skill picker and sent-message $name chips using skills from the open project/worktree instead of the server’s startup directory.

Adds provider.listWorkspaceSkills (read-scoped RPC) with contracts for input/result/source: workspace | snapshot. The server resolves cwd from thread.worktreePath ?? project.workspaceRoot, validates thread ownership, and calls an optional listSkillsForCwd on provider instances—with a 30s TTL cache per (instanceId, cwd) that does not mutate provider snapshots. Codex spawns a short-lived app-server in the workspace and calls skills/list; Claude uses discoverClaudeSkills for the resolved cwd; other drivers return source: "snapshot" so clients keep snapshot skills.

On the web, useWorkspaceSkills fetches the workspace catalog for the composer ($ menu, slash skills) and the timeline so chips survive sending. Skill chip UI is aligned (shared wrapper class, smaller skill icon) and timeline chips get description tooltips like the composer.

^{Reviewed by Cursor Bugbot for commit 26e4a23f392d6c6c72e285dbb3fd001aee61177a. Configure here.}

Note

Fix skill chip icon styling and add description tooltips to sent message skill chips

• Updates SkillChip to use the shared INLINE_CHIP_WRAPPER_CLASS_NAME and dedicated SKILL_CHIP_ICON_CLASS_NAME so sent-message skill chips match file chip styling
• Adds a top-positioned tooltip to skill chips when a description is available, resolving via resolveInlineSkillDescription which prefers trimmed shortDescription over description- Refactors skill shape to the shared exported InlineSkill type across ChatMarkdown, MessagesTimeline, and SkillInlineText to carry description fields
• Updates ComposerSkillDecorator to use SKILL_CHIP_ICON_CLASS_NAME for icon sizing
• Documents composer skill discovery behavior for Codex, Claude, and OpenCode in composer.md

^{Macroscope summarized dab755e.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit 26e4a23. Configure here.}

[macroscopeapp]

Approvability

Verdict: Approved at dab755e

Macroscope's review found this PR approvable — This is a narrowly scoped web UI polish change that aligns existing skill chips and adds optional descriptions through the existing tooltip component. Its runtime impact is limited to presentation and hover behavior, with focused tests and no schema, workflow, deployment, or sensitive-data changes.

^{You can add or adjust custom eligibility rules. Learn more.}

Dismissing prior approval to re-evaluate 01313dd

Dismissing prior approval to re-evaluate dab755e