team-shinchan:setup-hud

To configure a Claude statusline HUD, you register the plugin's statusline script path in your ~/.claude/settings.json. This Skill automates that installation by detecting the plugin root and writing the statusLine entry directly into your configuration file.

To safely remove a statusline configuration, the Skill first verifies that the existing statusLine entry points to the specific plugin script before deleting it. This validation prevents accidentally overwriting or removing unrelated configurations in your ~/.claude/settings.json.

Yes, the CLAUDE_PLUGIN_ROOT environment variable is required to install the HUD statusline. The Skill uses this variable to locate the plugin's statusline script and reports a clear error if the variable is missing or the script cannot be found.

You can overwrite an existing statusline entry safely because the Skill asks for explicit user consent before modifying your ~/.claude/settings.json. It also validates the target script path and checks ownership before removing any prior configuration.

Your Claude plugin statusline may not show up if the plugin's src/statusline/index.js script is missing or the CLAUDE_PLUGIN_ROOT variable is unset. The Skill validates script existence and environment variables during installation to prevent these configuration errors.

The best way to update a Claude HUD statusline configuration is to run the setup process again to rewrite the statusLine entry in ~/.claude/settings.json. The Skill handles path detection and prompts for confirmation before overwriting the existing entry.