Update Config Skill | Agent Skills

Update Config

Manage files under ~/.scriptkit that control launcher behavior, hotkeys, dictation, theming, and Tab AI.

Files That Matter

| File | Purpose | Reload | |------|---------|--------| | ~/.scriptkit/plugins/scriptkit/skills/ | Agent-readable skills | Read from Script Kit plugin | | ~/.scriptkit/config.ts | Full config: hotkeys, built-ins, runtime preferences, Claude Code | Auto-reloads | | ~/.scriptkit/theme.json | Theme colors | Auto-reloads |

What Goes Where

| Setting | File | Key | |---------|------|-----| | Launcher hotkey | config.ts | hotkey | | AI/Logs/Dictation shortcuts | config.ts | aiHotkey, logsHotkey, dictationHotkey | | Dictation microphone | config.ts | dictation.selectedDeviceId | | Theme preset | config.ts | theme.presetId | | Agent Chat defaults | config.ts | ai.selectedAgentChatAgentId, ai.selectedModelId | | Snap mode | config.ts | windowManagement.snapMode | | External MCP servers | config.ts | mcp | | Theme colors | theme.json | colors.* | | Claude Code | config.ts | claudeCode |

Hotkey Format

Use KeyboardEvent.code values. Valid modifiers: meta, ctrl, alt, shift.

Common keys: Semicolon, Space, Enter, KeyK, KeyL, KeyD, Digit1.

Do not use command/control — use meta/ctrl.

UI Settings (config.ts)

editor: "code",
padding: { top: 8, left: 12, right: 12 },
editorFontSize: 16,
terminalFontSize: 14,
uiScale: 1.0,
builtIns: {
  clipboardHistory: true,
  appLauncher: true,
  windowSwitcher: true,
},

Command Overrides (config.ts)

commands: {
  "script/my-workflow": {
    shortcut: { modifiers: ["meta", "shift"], key: "KeyW" }
  },
  "builtin/app-launcher": { hidden: true },
  "builtin/empty-trash": { confirmationRequired: true }
}

Command deeplinks: scriptkit://commands/{id}

Auxiliary Hotkeys

notesHotkey — no default; set explicitly
aiHotkey — defaults to Cmd+Shift+Space when enabled
logsHotkey — defaults to Cmd+Shift+L when enabled
dictationHotkey — no default; set explicitly
All have *Enabled boolean (default true)

Runtime Preference Groups

theme: { presetId: "nord" },
dictation: { selectedDeviceId: "usb-mic" },
ai: {
  selectedAgentChatAgentId: "codex-agent_chat",
  selectedModelId: "gpt-5.4",
},
windowManagement: { snapMode: "expanded" },

MCP Servers

Use the top-level mcp key in config.ts for external MCP servers shared by scripts and Agent Chat.

mcp: {
  enabled: true,
  servers: {
    github: {
      transport: "stdio",
      command: "npx",
      args: ["-y", "@modelcontextprotocol/server-github"],
    },
  },
},

For MCP-specific workflows, use the mcp skill.

Common Mistakes

Putting skills at the workspace root instead of in ~/.scriptkit/plugins/scriptkit/skills/
Editing ~/.scriptkit/config.ts instead of ~/.scriptkit/config.ts
Using command/control instead of meta/ctrl
Editing theme.json when you meant to change theme.presetId in config.ts

References

See references/config-examples.md for full config.ts example, theme file format, frecency settings, watcher config, layout defaults, and Claude Code provider options.

Agent Skills: Update Config

Install this agent skill to your local

Skill Files