功能

Skills、Plugins & Marketplaces

查看 Markdown

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
pathsGitignore globs。在触及匹配文件前隐藏。
allowed-tools不会授予或限制工具。接受 YAML list,或逗号/空格分隔的字符串。
argument-hint斜杠命令 autocomplete hint。
user-invocable显示为斜杠命令。默认 truefalse 会对你和模型隐藏它。只有字面量 true 算 true;yes 是 false。
disable-model-invocation仅作为斜杠命令;不自动 invoke。默认 false
metadata字符串 map。authorshort-description 会显示在 UI 中。

Grok 接受 modeleffortlicensecompatibility,但不会应用它们。

Plugins

Plugins 通过额外的 skills、agents、hooks、MCP servers 和 LSP servers 扩展 Grok。

Grok 从以下位置加载 plugins:

  • ./.grok/plugins/

  • ~/.grok/plugins/

  • ~/.grok/plugins/marketplaces/ 下的 Marketplace 安装

  • [plugins] paths 下的额外路径,配置位于 ~/.grok/config.toml

  • CLI 上的 --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_ROOTGROK_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.mdClaude.mdCLAUDE.local.md.claude/rules/),并与 .grok/ 一起使用。无需额外设置。

Agents.md 兼容性

Grok 还会读取 AGENTS.md 指令文件系列(AGENTS.mdAgents.mdAGENT.md),从 cwd 向上遍历至仓库根目录;请参阅 AGENTS.md。它还会从以下位置发现用户级 skills 和 commands:

  • ~/.agents/skills/

  • ~/.agents/commands/


最后更新:2026 年 8 月 11 日