gui-settings-ui — Claude Code skill: what it does, how to install
gui-settings-ui is a Claude Code skill for editing Warp GUI settings pages. It keeps widget visibility and settings search aligned with the page structure.
AGPL-3.0 ★ 720 updated 2026-11-10
npx skills add dominikmartn/harp --skill gui-settings-ui -a claude-codeWhat gui-settings-ui does
gui-settings-ui guides changes to Warp’s settings view. It covers PageType, SettingsWidget, page-level headings, and the search terms attached to each widget, so a settings page can be split and filtered consistently.
Search works at widget level: every word in a query must match the widget’s search string. The skill also separates checks made while constructing a page from should_render, which is evaluated again as the app runs. Fixed feature or platform conditions belong in page construction; values that can change during a session belong in the widget check.
The scope is limited to the GUI desktop app under app/src/settings_view/; it does not cover the headless TUI in crates/warp_tui. It applies when adding or editing a settings page, a SettingsWidget, or settings-search behavior.
What it helps with
- create a Warp settings page with the right
PageType - place a heading in the page title slot or inside a widget
- scope search terms to the widget that owns the setting
- choose between build-time gating and
should_render - keep filtered settings pages from showing empty widget content
Example prompts for the agent
- Add a settings page for a new Warp section and choose the right
PageType. - Check where the heading belongs and define
search_termsfor eachSettingsWidget. - Gate this widget with
should_renderwhen its availability can change during the session.
How to install gui-settings-ui
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill gui-settings-ui -a claude-code2Manually: put the files in place
~/.claude/skills/gui-settings-ui/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gui-settings-ui/
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill gui-settings-ui -a codex2Manually: put the files in place
.agents/skills/gui-settings-ui/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill gui-settings-ui -a cursor2Manually: put the files in place
.cursor/skills/gui-settings-ui/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dominikmartn/harp .agents/skills/gui-settings-ui2Manually: put the files in place
.github/skills/gui-settings-ui/SKILL.md1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill gui-settings-ui -a gemini-cli2Platform CLI
gemini skills install https://github.com/dominikmartn/harp --path .agents/skills/gui-settings-uiManually: put the files in place
.devin/skills/gui-settings-ui/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about gui-settings-ui
How do I install gui-settings-ui in Claude Code?
Run npx skills add dominikmartn/harp --skill gui-settings-ui -a claude-code. The skill file will be at ~/.claude/skills/gui-settings-ui/SKILL.md.
What does gui-settings-ui do?
It guides Warp GUI settings-page work, including PageType selection, heading placement, widget search terms, and conditional visibility. It also distinguishes page construction checks from should_render.
Which part of Warp does gui-settings-ui support?
The skill targets the GUI desktop app and files under app/src/settings_view/. It does not cover the headless TUI in crates/warp_tui.