New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Warp Settings Editor

by warpdotdev in warpdotdev/warp

Finds and changes Warp application settings by searching a bundled JSON schema and editing the matching TOML settings file at the right nesting depth.

AGPL-3.0Auto-check passedProductivity & Automation

Install Warp Settings Editor

skills CLI
$ npx skills add warpdotdev/warp --skill modify-settings -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install warpdotdev/warp modify-settings --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/warpdotdev/warp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/resources/bundled/skills/modify-settings .claude/skills/modify-settings && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
modify-settings
GitHub stars
65k
Used in
1 other repo
Token cost
~675 tokens
SKILL.md length
327 words
Files
2 (incl. scripts)
Skills in repo
46
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Finds and changes Warp application settings by searching a bundled JSON schema and editing the matching TOML settings file at the right nesting depth.

  • Works in 3 steps: Find the setting — use grep to identify… → Read current value — check the settings… → Apply the change — add or update the…
  • Changing a Warp setting such as font size or theme
  • SKILL.md covers Settings Schema, Settings File and Workflow
  • Runs Python scripts from its folder; calls python3

What it does

The skill relies on a bundled JSON schema, written to JSON Schema draft 2020-12, that lists every Warp setting with its description, type, default and allowed values. The agent first greps the schema for candidate key names, then runs scripts/find_setting.py with the schema and the key to get the full dotted path and definition, because several sections share similar names and nesting must never be guessed from grep output.

Settings themselves live in a TOML file whose section headers mirror the schema hierarchy, so a property two levels under appearance becomes a table named appearance.themes. The agent counts the full depth before writing a header, reads the current value to see whether the setting is already configured, creates the file if it does not exist, and relies on Warp hot-reloading it so changes apply immediately.

When your agent uses it

  • Changing a Warp setting such as font size or theme
  • Checking the current value or valid options for a Warp setting
  • Troubleshooting a Warp setting that does not seem to apply

Example prompts

  • “Switch my Warp theme to light and show me the TOML section you changed.”
  • “List the valid values for Warp's input mode setting.”
  • “Find the setting that controls the tab bar and tell me what it is currently set to.”

Requirements

  • Warp with its bundled settings schema
  • Python 3, for find_setting.py

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Find the setting — use grep to identify candidate key names, then run the Python path-tracing script to get the full dotted path and the…
  2. Read current value — check the settings file to see whether the setting is already configured.
  3. Apply the change — add or update the setting in the TOML file with a valid value from the schema.

What it can do on your machine

Read from SKILL.md and the folder at commit f571865. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Warp Settings Editor loads about 675 tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 327 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~25
When it runs · the whole SKILL.md, loaded when a task matches
~675

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from warpdotdev/warp at commit f571865, republished under its AGPL-3.0 licence (© warpdotdev). 327 words, ~675 tokens.

Download SKILL.mdSave it as .claude/skills/modify-settings/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
modify-settings
description
View or modify Warp application settings using the bundled JSON schema for guidance

modify-settings

Use this skill when the user wants to view, change, or troubleshoot Warp application settings.

Settings Schema

A JSON schema describing all available settings is bundled at:

{{settings_schema_path}}

The schema follows JSON Schema draft 2020-12, with settings organized hierarchically under properties. Each setting includes:

  • description — what the setting controls
  • type — the value type (string, boolean, integer, etc.)
  • default — the default value
  • enum or oneOf — valid values, when the setting is constrained
Finding a setting

Use grep to do an initial broad search for candidate key names:

sh
grep -i "font" {{settings_schema_path}}

Once you have a candidate key name, run the bundled script to get the full dotted path, the setting's properties, and any parent context. This is critical — the schema has multiple sections with similar names (e.g. several input keys), so never assume the nesting from grep output alone.

sh
python3 {{skill_dir}}/scripts/find_setting.py {{settings_schema_path}} <key_name>

The output gives you the unambiguous full path (e.g. properties.appearance.properties.input.properties.input_mode) and the setting's full definition including valid values.

Settings File

The user's settings are stored in a TOML file at:

{{settings_file_path}}

Settings use dotted TOML section headers matching the schema hierarchy. Always trace the full nesting path from the schema to the TOML — each intermediate properties key becomes a section level. For example:

A property at properties.appearance.properties.font_size (one level deep) corresponds to:

toml
[appearance]
font_size = 14

A property at properties.appearance.properties.themes.properties.theme (two levels deep) corresponds to:

toml
[appearance.themes]
theme = "light"

A common mistake is to stop one level too early — always count the full depth before writing the TOML section header.

If the file does not exist yet, create it. Warp hot-reloads this file, so changes take effect immediately.

Workflow

  1. Find the setting — use grep to identify candidate key names, then run the Python path-tracing script to get the full dotted path and the setting's valid values. Never rely on grep output alone to infer nesting.
  2. Read current value — check the settings file to see whether the setting is already configured.
  3. Apply the change — add or update the setting in the TOML file with a valid value from the schema.

© warpdotdev, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in resources/bundled/skills/modify-settings of warpdotdev/warp.

  • SKILL.md
  • scripts/find_setting.py

Open the folder on GitHubat commit f571865

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in warpdotdev/warp, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Warp Settings Editor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Warp Settings Editor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Warp Settings Editor this skillwarpdotdev/warp65k1 repos~675Automated safety check: PassAGPL-3.0
Process Inboxtelegramdesktop/tdesktop33k2 repos~4.5kAutomated safety check: PassGPL-3.0
Tavily Web Searchallenpeng0705/EnvoyMesh3.1k4 repos~2.5kAutomated safety check: NotesNone
Disk Storage AnalyzerKKKKhazix/khazix-skills21k1 repos~1.4kAutomated safety check: PassMIT
MoviePilot Downloader Operationjxxghp/MoviePilot12k—~4.4kAutomated safety check: PassGPL-3.0
Browser Automation Edge Casesaden-hive/hive11k—~1.8kAutomated safety check: PassMIT

Similar skills

  • Process Inbox

    telegramdesktop/tdesktop

    Process the local ignored ai-tdesktop inbox into durable, independently testable Telegram Desktop task records while task execution worktrees remain active.

    33k GitHub starsUsed in 2 repos~4.5k tokens
    Productivity & AutomationAuto-check passed

  • Tavily Web Search

    allenpeng0705/EnvoyMesh

    Searches the web through the Tavily API with LLM-friendly output: clean structured results, optional AI-written answers, domain filters, news mode, images and raw content.

    3.1k GitHub starsUsed in 4 repos~2.5k tokens
    Productivity & AutomationAuto-check: notes

  • Disk Storage Analyzer

    KKKKhazix/khazix-skills

    Scans a Mac or Windows PC read-only to find what fills the disk, grades each item by how safe it is to clean and builds an interactive HTML report.

    21k GitHub starsUsed in 1 repo~1.4k tokens
    Productivity & AutomationAuto-check passed

  • MoviePilot Downloader Operation

    jxxghp/MoviePilot

    Inspects, diagnoses and directly controls qBittorrent, Transmission or rTorrent downloaders configured in MoviePilot through a bundled Python helper.

    12k GitHub stars~4.4k tokensUpdated today
    Productivity & AutomationAuto-check passed

  • Browser Automation Edge Cases

    aden-hive/hive

    Step-by-step procedure for debugging browser automation failures on complex sites such as LinkedIn, Twitter/X, single-page apps and Shadow DOM pages.

    11k GitHub stars~1.8k tokensUpdated 23 days ago
    Productivity & AutomationAuto-check passed

  • Skyvern Browser Automation

    Skyvern-AI/skyvern

    Automates websites with Skyvern's AI browser agent to fill forms, extract data, download files, log in and run multi-step workflows through SDKs, REST, MCP or a CLI.

    23k GitHub stars~1.9k tokensUpdated today
    Productivity & AutomationAuto-check passed

More from warpdotdev/warp

All 46 skills in this repo

  • Figma Design System Builder

    warpdotdev/warp

    Builds or updates a design system in Figma from a codebase in ordered phases: discovery, variables and tokens, components, theming and documentation, with checkpoints.

    65k GitHub starsUsed in 2 repos~4.4k tokens
    Auto-check passed

  • Figma use_figma Plugin API Rules

    warpdotdev/warp

    Required groundwork before any use_figma call: the rules and reference files for running JavaScript in a Figma file through the Plugin API without common failures.

    65k GitHub starsUsed in 4 repos~4.4k tokens
    Auto-check passed

  • Warp Factory Files

    warpdotdev/warp

    Authors and edits file-based Warp software factory definitions rooted at factory.yaml, covering agents, automations, scorers and webhooks, and validates them before a pull request.

    65k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed

  • Figma Design to Code

    warpdotdev/warp

    Turns a Figma frame or component into production code that matches the design, using the Figma MCP server and the project's own design system.

    65k GitHub starsUsed in 4 repos~2.9k tokens
    Auto-check passed

  • Warp GUI to Agent CLI Migration

    warpdotdev/warp

    Migrates the compatible subset of settings and global file-based MCP servers from the Warp desktop app into Warp Agent CLI without exposing credentials or state.

    65k GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed

  • Figma Design System Rules Generator

    warpdotdev/warp

    Creates project-specific design system rules from your codebase so coding agents implement Figma designs with your components, naming and tokens.

    65k GitHub starsUsed in 3 repos~4.6k tokens
    Auto-check passed

Works with

Categories

Questions about Warp Settings Editor

What does Warp Settings Editor do?

Finds and changes Warp application settings by searching a bundled JSON schema and editing the matching TOML settings file at the right nesting depth. The skill relies on a bundled JSON schema, written to JSON Schema draft 2020-12, that lists every Warp setting with its description, type, default and allowed values.py with the schema and the key to get the full dotted path and definition, because several sections share similar names and nesting must never be guessed from grep output.

When should I use Warp Settings Editor?

Warp Settings Editor fits situations like: changing a Warp setting such as font size or theme; checking the current value or valid options for a Warp setting; troubleshooting a Warp setting that does not seem to apply.

How do I install Warp Settings Editor in Claude Code?

Run `npx skills add warpdotdev/warp --skill modify-settings -a claude-code`. Or copy the skill folder (resources/bundled/skills/modify-settings in warpdotdev/warp) into .claude/skills/modify-settings in your project. Claude Code loads it when a task matches its description.

How do I install Warp Settings Editor in Codex?

Run `npx skills add warpdotdev/warp --skill modify-settings -a codex`. Or copy the skill folder (resources/bundled/skills/modify-settings in warpdotdev/warp) into .agents/skills/modify-settings in your project. Codex loads it when a task matches its description.

Can I use Warp Settings Editor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add warpdotdev/warp --skill modify-settings -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/modify-settings, .gemini/skills/modify-settings, .github/skills/modify-settings and .opencode/skills/modify-settings in your project.

What does Warp Settings Editor need to run?

Going by SKILL.md and its folder, Warp Settings Editor needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Warp with its bundled settings schema; Python 3, for find_setting.py.

Does Warp Settings Editor access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Warp Settings Editor safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Warp Settings Editor use?

Warp Settings Editor is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Warp Settings Editor use?

About 675 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Warp Settings Editor?

Skills that share tags, products or a category with Warp Settings Editor: Process Inbox (telegramdesktop/tdesktop, 33k stars), Tavily Web Search (allenpeng0705/EnvoyMesh, 3.1k stars), Disk Storage Analyzer (KKKKhazix/khazix-skills, 21k stars) and MoviePilot Downloader Operation (jxxghp/MoviePilot, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Warp Settings Editor?

warpdotdev (a GitHub organization) maintains it in warpdotdev/warp, which has 65,380 GitHub stars. The repository holds 46 skills in this directory. The repository was last updated on October 7, 2026.

Source: warpdotdev/warp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.