modify-settings — Claude Code skill: what it does, how to install
modify-settings is a Claude Code skill that inspects and edits Warp terminal preferences using JSON Schema. It updates the user TOML configuration without breaking nested sections.
AGPL-3.0 ★ 720 updated 2026-11-10
npx skills add dominikmartn/harp --skill modify-settings -a claude-codeWhat modify-settings does
The skill navigates the Warp terminal configuration schema to discover valid keys and update settings in the TOML file. It spots candidate properties with grep, then resolves the exact dotted path via find_setting.py. That script outlines parameter types, defaults, and permitted values.
Each schema level maps directly into dotted TOML section headers. The target file is generated automatically when missing. Warp applies new values instantly through hot-reloading.
Running the bundled path helper requires python3. Precise hierarchy tracing prevents misplaced keys in complex nested sections.
What it helps with
- locate setting keys inside the Warp JSON schema
- update appearance and input parameters in the Warp TOML file
- verify accepted types and enum values for Warp options
- generate missing Warp configuration files with valid section nesting
Example prompts for the agent
- Set the font size to 14 in my Warp configuration
- Check what input modes are supported in Warp settings
- Switch the Warp theme to light mode in the TOML file
How to install modify-settings
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill modify-settings -a claude-code2Manually: put the files in place
~/.claude/skills/modify-settings/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/modify-settings/
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill modify-settings -a codex2Manually: put the files in place
.agents/skills/modify-settings/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill modify-settings -a cursor2Manually: put the files in place
.cursor/skills/modify-settings/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dominikmartn/harp resources/bundled/skills/modify-settings2Manually: put the files in place
.github/skills/modify-settings/SKILL.md1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill modify-settings -a gemini-cli2Platform CLI
gemini skills install https://github.com/dominikmartn/harp --path resources/bundled/skills/modify-settingsManually: put the files in place
.devin/skills/modify-settings/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 modify-settings
How to install modify-settings in Claude Code?
Run npx skills add dominikmartn/harp --skill modify-settings -a claude-code. The file will be placed at ~/.claude/skills/modify-settings/SKILL.md.
What does modify-settings do?
It queries the Warp configuration schema and writes validated settings into the user's TOML file.
What is required for modify-settings to run?
It requires python3 in the environment to execute the bundled find_setting.py path resolver.