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

Plugin hooks additionally receive GROK_PLUGIN_ROOT and GROK_PLUGIN_DATA in their environment. For events, the JSON format, and the script contract, see Hooks.

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 — see AGENTS.md — and discovers user-level skills and commands from:

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