Skills, Plugins & Marketplaces

Skills are reusable folders containing markdown instructions, script files, and resources for agents.

Grok discovers skills from:

• ./.grok/skills/ (walked up to the repo root)
• ~/.grok/skills/
• Any enabled plugin's skills/ directory
• Extra paths under [skills] paths in ~/.grok/config.toml

User-invocable skills also appear as slash commands, for example /<skill-name>.

Plugins extend Grok with additional skills, agents, hooks, MCP servers, and LSP servers.

Grok loads plugins from:

• ./.grok/plugins/
• ~/.grok/plugins/
• Marketplace installs under ~/.grok/plugins/marketplaces/
• Extra paths under [plugins] paths in ~/.grok/config.toml
• --plugin-dir <PATH> on the CLI

Manage plugins, hooks, skills, and MCP servers from a single extensions modal in the TUI — open it with any of /plugins, /hooks, /skills, or /mcps.

Hooks run scripts on tool and session lifecycle events, such as before or after tool calls.

Grok discovers hooks from:

• ~/.grok/hooks/ (extra roots via ~/.grok/hooks-paths)
• Project .grok/hooks/ (requires /hooks-trust)
• Enabled plugins

All hooks receive GROK_HOOK_EVENT, GROK_HOOK_NAME, GROK_SESSION_ID, and GROK_WORKSPACE_ROOT. Plugin hooks also receive GROK_PLUGIN_ROOT and GROK_PLUGIN_DATA. Runner and plugin values take precedence over any env declared in the hook definition. See the in-app Hooks guide for expansion rules and full details.

The TUI includes a Marketplace tab for browsing and installing plugins from configured sources.

Marketplace sources come from [[marketplace.sources]] in ~/.grok/config.toml and ~/.grok/plugins/known_marketplaces.json.

Subagents spawn independent child sessions that handle tasks in parallel.

Grok is fully compatible with Claude Code with zero configuration needed.

Grok automatically reads Claude Code marketplaces, plugins, skills, MCPs, agents, hooks, and instruction files (CLAUDE.md, Claude.md, CLAUDE.local.md, and .claude/rules/) alongside .grok/. No extra setup is needed.

Grok also reads the AGENTS.md instruction-file family (AGENTS.md, Agents.md, AGENT.md) walked from cwd to the repo root, and discovers user-level skills and commands from:

• ~/.agents/skills/
• ~/.agents/commands/