rickyauditore507

Claude Skill Wheel — Development skill for Claude Code

Development community

A radial skill picker for Claude Code (Windows overlay + VS Code companion).

How to install Claude Skill Wheel

This entry records only its repository, not the path inside it, so there is no exact command to give. Open rickyauditore507/claude-skill-wheel and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claude Skill Wheel does

A radial skill picker for Claude Code (Windows overlay + VS Code companion).

Alternatives in Development

Family Picker — family-picker 1k ★
Maestro Next — Unified entry for all development intents — classify intent, assess complexity, route to the correct execution 530 ★
Tmux Claude Hatch — tmux plugin that runs Claude Code sessions in popups per project directory, with an fzf picker showing each se 381 ★

README

Skill Wheel

[![CI](https://github.com/rickyauditore507/claude-skill-wheel/actions/workflows/ci.yml/badge.svg)](https://github.com/rickyauditore507/claude-skill-wheel/actions/workflows/ci.yml)

![Skill Wheel](assets/banner.png)

按住 **Ctrl + Alt + Space**（默认，可在配置里改），屏幕上弹出一圈已安装的 Claude Code skills；鼠标滑到哪个扇形，哪个就放大；滚轮切换下一页圆盘；**松开按键**就把 `/skill名 ` 写进 Claude 输入框。鼠标没动就松开 = 取消。

        ┌──────────────────────────┐
        │ holding Ctrl+Alt+Space   │
        │      ╭──────────╮        │
        │   ╭──┤  skill  ├──╮     │
        │   │  ╰──────────╯  │     │
        │   │   hover → 放大  │     │
        │   ╰────────────────╯     │
        └──────────────────────────┘

组成

部分	作用
`overlay/`（Python + PySide6）	透明置顶圆盘、全局热键、鼠标悬停/滚轮、注入文本
`extension/`（VS Code 扩展）	随 VS Code 启停 overlay、状态栏、`/focus-claude` 桥

VS Code 扩展 API 本身做不了透明悬浮窗，所以圆盘由 Python 层绘制；扩展负责生命周期和聚焦 Claude 输入框。

安装（源码）

git clone https://github.com/rickyauditore507/claude-skill-wheel.git
cd claude-skill-wheel
uv venv --python 3.12 .venv
uv pip install --python .venv\Scripts\python.exe -r requirements.txt
powershell -File .\install.ps1

`install.ps1` 会把 `extension/` 复制到 `~/.vscode/extensions/ricky.skill-wheel-/`，然后重载 VS Code 窗口。被执行策略拦住时，先运行 `Set-ExecutionPolicy -Scope Process RemoteSigned` 再执行脚本。

配置 / 日志：~/.claude/skill-wheel/（config.json、usage.json、overlay.log）
技能来源：~/.claude/skills/*/SKILL.md

启用

VS Code 里执行 Developer: Reload Window（或重启 VS Code）。
右下角出现 Skill Wheel 状态栏；点击可启停。
打开 Claude Code 面板，按住 Ctrl + Alt + Space（默认），移动鼠标选 skill，松开。

状态栏 / 命令：`Skill Wheel: Start overlay`、`Stop overlay`、`Restart overlay`、`Open config`、`Show logs`。

配置

编辑 `~/.claude/skill-wheel/config.json`（改完执行 `Skill Wheel: Restart overlay`）：

键	默认	说明
`trigger`	`"ctrl+alt+space"`	全局触发键。别用单独的 Alt 组合（VS Code 会进入菜单访问键模式）；可用 `ctrl+alt+space`、ctrl+alt+\``、alt+caps_lock`（后者仍有 Alt）
`skillsPerPage`