tab-configs — Claude Code skill: install and use
tab-configs is a Claude Code skill that documents Warp tab config schemas and checks. It activates while creating or editing tab-config TOML files.
AGPL-3.0 ★ 720 updated 2026-11-10
npx skills add dominikmartn/harp --skill tab-configs -a claude-codeWhat tab-configs does
tab-configs documents how Warp tab config TOML files are structured. It covers display fields, the flat [[panes]] collection, leaf and split nodes, commands, working directories, shells, focus, and pane types.
The skill lists tree checks for unique IDs, valid children references, acyclic layouts, and a single focused pane at most. It also explains parameter tables, {{name}} templates, and the reserved {{autogenerated_branch_name}} variable. Standard Warp builds read configs from ~/.warp/tab_configs/; channel builds such as Preview use a path like ~/.warp-<channel>/tab_configs/.
The config directory must match the active Warp build. tab-configs also supplies shared context for create-tab-config and update-tab-config, and can be invoked directly for creating or editing a file.
What it helps with
- create a Warp tab layout in TOML
- validate pane references and unique node IDs
- assign commands, directories, shells, and initial focus
- define project or branch parameters for a tab
- locate the config directory for a Warp channel
Example prompts for the agent
- Create a Warp tab config for
~/code/my-appwith editor and server panes. - Check this Warp TOML file for invalid
childrenlinks, pane types, and focus settings. - Update the tab config with a branch parameter and use
{{branch}}in a startup command.
How to install tab-configs
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill tab-configs -a claude-code2Manually: put the files in place
~/.claude/skills/tab-configs/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/tab-configs/
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill tab-configs -a codex2Manually: put the files in place
.agents/skills/tab-configs/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill tab-configs -a cursor2Manually: put the files in place
.cursor/skills/tab-configs/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dominikmartn/harp resources/bundled/skills/tab-configs2Manually: put the files in place
.github/skills/tab-configs/SKILL.md1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill tab-configs -a gemini-cli2Platform CLI
gemini skills install https://github.com/dominikmartn/harp --path resources/bundled/skills/tab-configsManually: put the files in place
.devin/skills/tab-configs/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 tab-configs
How do I install tab-configs in Claude Code?
Run npx skills add dominikmartn/harp --skill tab-configs -a claude-code. The installed skill is placed at ~/.claude/skills/tab-configs/SKILL.md.
What does tab-configs do?
It documents Warp tab config TOML schemas, pane layouts, parameters, and validation rules. It supports creating and editing tab configuration files.
Which pane types does tab-configs support?
Leaf panes can use terminal, agent, or cloud. Split nodes use horizontal or vertical and must reference at least two child panes.