功能
Skills、Plugins & Marketplaces
Skills
Skills 是包含 Markdown 指令、脚本文件和供 Agent 使用资源的可复用目录。
Grok 从以下位置发现 skills:
./.grok/skills/(向上遍历至仓库根目录)~/.grok/skills/任意已启用 plugin 的
skills/目录[skills] paths下的额外路径,配置位于~/.grok/config.toml
可由用户调用的 skills 也会作为斜杠命令显示,例如 /<skill-name>。
SKILL.md 以 YAML frontmatter 开头。额外 key 会被忽略。
| 字段 | 说明 |
|---|---|
name | 标识符。省略时使用目录名。 |
description | 它做什么,以及何时使用。省略时使用正文第一段。 |
when-to-use | 额外触发短语。别名:when_to_use。 |
paths | Gitignore globs。在触及匹配文件前隐藏。 |
allowed-tools | 不会授予或限制工具。接受 YAML list,或逗号/空格分隔的字符串。 |
argument-hint | 斜杠命令 autocomplete hint。 |
user-invocable | 显示为斜杠命令。默认 true。false 会对你和模型隐藏它。只有字面量 true 算 true;yes 是 false。 |
disable-model-invocation | 仅作为斜杠命令;不自动 invoke。默认 false。 |
metadata | 字符串 map。author 和 short-description 会显示在 UI 中。 |
Grok 接受 model、effort、license 和 compatibility,但不会应用它们。
Plugins
Plugins 通过额外的 skills、agents、hooks、MCP servers 和 LSP servers 扩展 Grok。
Grok 从以下位置加载 plugins:
./.grok/plugins/~/.grok/plugins/~/.grok/plugins/marketplaces/下的 Marketplace 安装[plugins] paths下的额外路径,配置位于~/.grok/config.tomlCLI 上的
--plugin-dir <PATH>
TUI 提供统一的扩展模态窗口,用于管理 plugins、hooks、skills 和 MCP servers;可通过 /plugins、/hooks、/skills 或 /mcps 中任一命令打开。
Hooks
Hooks 会在工具和会话生命周期事件中运行脚本,例如在工具调用之前或之后。
Grok 从以下位置发现 hooks:
~/.grok/hooks/(通过~/.grok/hooks-paths添加额外根目录)项目
.grok/hooks/(需要/hooks-trust)已启用 plugins
Plugin hooks 还会在环境中收到 GROK_PLUGIN_ROOT 和 GROK_PLUGIN_DATA。有关事件、JSON 格式和脚本约定,请参阅 Hooks。
Marketplaces
TUI 包含 Marketplace tab,用于浏览和安装配置来源中的 plugins。
Marketplace 来源来自 [[marketplace.sources]](位于 ~/.grok/config.toml)和 ~/.grok/plugins/known_marketplaces.json。
Subagents
Subagents 会创建处理并行任务的独立子会话。有关类型和 personas,请参阅 Subagents。
Claude Code 兼容性
Grok 无需任何配置即可完整兼容 Claude Code。
Grok 会自动读取 Claude Code marketplaces、plugins、skills、MCPs、agents、hooks 和指令文件(CLAUDE.md、Claude.md、CLAUDE.local.md 和 .claude/rules/),并与 .grok/ 一起使用。无需额外设置。
Agents.md 兼容性
Grok 还会读取 AGENTS.md 指令文件系列(AGENTS.md、Agents.md、AGENT.md),从 cwd 向上遍历至仓库根目录;请参阅 AGENTS.md。它还会从以下位置发现用户级 skills 和 commands:
~/.agents/skills/~/.agents/commands/
最后更新:2026 年 8 月 11 日