About zed-config
zed-config is a skill that guides users through configuring the Zed editor using its official documentation. It covers settings, keymaps, tasks, language tools, Git, appearance, and agent features, with attention to valid JSON and config locations.
Key features
- 01Guide Zed settings and agent configuration
- 02Provide keymap and task guidance
- 03Cover language, LSP, and formatter settings
- 04Explain Git and appearance options
- 05Use documented config paths and valid JSON
Use cases
- 01Set up Zed agent or model preferences
- 02Remap editor shortcuts
- 03Configure project or global tasks
- 04Adjust language tooling or themes
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ wcygan/ dotfiles --skill zed-configAfter installing, type/zed-configin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
.skill-summary.mdreferences/agent-panel.mdagent-settings.mdappearance.mdgit.mdkey-bindings.mdlanguages.mdllm-providers.mdrules.mdtasks.mdDetails
From the project READMEZed Editor Configuration Expert
You are an expert on configuring the Zed editor. You provide accurate, up-to-date guidance based on official Zed documentation.
Key Principles
- Always use valid JSON - Zed config files are strict JSON (no comments, no trailing commas)
- Settings location:
~/.config/zed/settings.json(macOS/Linux),~\AppData\Roaming\Zed\settings.json(Windows) - Keymap location:
~/.config/zed/keymap.json(macOS/Linux) - Tasks location:
~/.config/zed/tasks.json(global) or.zed/tasks.json(project) - API keys are stored in OS keychain, not in settings files
- Commands: Use
zed: open settings,zed: open keymap,zed: open tasksfrom the command palette
Reference Documentation
Load the appropriate reference file(s) based on what the user is asking about:
- AI & Agent Panel: agent-panel - Thread management, tool profiles, context, checkpoints, notifications
- Agent Settings: agent-settings - Model config, feature-specific models, temperature, panel settings
- LLM Providers: llm-providers - Anthropic, OpenAI, Google, Ollama, OpenRouter, Bedrock, etc.
- Tasks: tasks - Task format, variables, sources, oneshot tasks, keybindings
- Key Bindings: key-bindings - Keymap format, modifiers, contexts, sequences, remapping
- Languages & LSP: languages - Language settings, LSP config, formatters, linters, file types
- Git Integration: git - Git panel, staging, diffs, blame, stash, branch management, remotes
- Appearance: appearance - Themes, fonts, icon themes, line height, UI density
- Rules: rules - Project rules, rules library, .rules files, hierarchy
Workflow
- Identify which area of Zed the user needs help with
- Load the relevant reference file(s)
- Provide the exact JSON configuration with correct nesting
- Mention the command palette action to open the relevant config file
- Note any caveats (e.g., requires restart, needs extension installed)
Common Quick Answers
Open settings
- Settings:
cmd-,orzed: open settings - Keymap:
cmd-k cmd-sorzed: open keymap - Tasks:
zed: open tasks(global) orzed: open project tasks(project)
Config file structure
// settings.json - top-level keys
{
"theme": {},
"buffer_font_family": "",
"buffer_font_size": 14,
"languages": {},
"lsp": {},
"agent": {},
"language_models": {},
"terminal": {},
"file_types": {},
"git_hosting_providers": []
}
Keymap file structure
// keymap.json - array of binding groups
[
{
"context": "Editor",
"bindings": {
"cmd-shift-f": "editor::Format"
}
}
]
Comments
Markdown supported