Statusline Setup Skill
This skill auto-triggers when users want to set up, configure, or customize their Claude Code statusline.
When This Triggers
- "setup statusline" / "install statusline"
- "configure statusline" / "statusline config"
- "change statusline theme"
- "customize statusline"
- "statusline widgets"
- "enable/disable statusline widget"
What To Do
For Setup/Install Requests
-
Check if the plugin is already installed by looking for
~/.claude/statusline-config.json -
If not installed, run the install command:
/ultimate-statusline:install -
Guide the user through initial configuration
For Theme Changes
-
Show available themes:
- default (balanced colors)
- gruvbox (warm retro)
- nord (arctic blues)
- tokyo-night (neon cyberpunk)
- rose-pine (soft pastels)
- powerline (classic vim powerline)
-
Apply the requested theme:
/ultimate-statusline:config set theme <theme-name>
For Widget Configuration
-
If user wants to see available widgets:
/ultimate-statusline:widgets -
If user wants to enable/disable a widget:
/ultimate-statusline:config set widgets.<widget_name>.enabled true/false -
Common widget requests:
- "show MCP status" → enable
mcp_status - "show cost per hour" → enable
burn_rate - "show daily cost" → enable
daily_cost - "hide git info" → disable
git_branchandgit_changes - "show token usage" → enable
tokens_totalortokens_input/tokens_output
- "show MCP status" → enable
For Preview Requests
-
Show what the statusline will look like:
/ultimate-statusline:preview -
Preview with a specific theme:
/ultimate-statusline:preview --theme <theme-name>
Available Widgets
Always mention these key widgets:
| Widget | What it shows |
|--------|---------------|
| model_emoji | 🧠 Opus, 🎵 Sonnet, ⚡ Haiku |
| context_percent | Usage % with progress bar |
| session_cost | Current session cost |
| burn_rate | Cost per hour 🔥 |
| mcp_status | MCP server health 🟢/🔴 |
| git_branch | Current git branch |
| daily_cost | Today's spending (needs ccusage) |
Response Pattern
After helping the user configure the statusline:
- Summarize what was changed
- Remind them to restart Claude Code if settings.json was modified
- Suggest running
/ultimate-statusline:previewto see the result