菜单
统一使用 Grok 完成聊天、推理、X 搜索、图片生成、视频生成、文本转语音、语音转文字和代理接入的能力路由技能。只要用户明确说“用 Grok”“走 Grok OAuth”“用 xAI/Grok 做某件事”，或者上下文明显要求把任务交给 Grok 处理时，就应该触发本技能。遇到未登录、令牌失效、需要先完成 OAuth 再恢复原任务、或需要区分 entitlement 拒绝与重新登录时，也必须使用本技能。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use this skill whenever the user wants to use Grok or xAI through the grok-cli command line, including chat, X search, image generation/editing, video generation/editing/extension, text-to-speech, speech-to-text, OAuth login/status, or local usage stats. This skill should also be used when grok-cli may need to be installed first; it runs the user's requested grok-cli command directly when possible, repairs install/auth/permission problems only after an actual failure, retries the original task after recovery, and returns Grok/grok-cli results without assistant-side rewriting unless the user explicitly asks for transformation.
统一使用 Grok 完成聊天、推理、X 搜索、图片生成、视频生成、文本转语音、语音转文字和代理接入的能力路由技能。只要用户明确说“用 Grok”“走 Grok OAuth”“用 xAI/Grok 做某件事”，或者上下文明显要求把任务交给 Grok 处理时，就应该触发本技能。遇到未登录、令牌失效、需要先完成 OAuth 再恢复原任务、或需要区分 entitlement 拒绝与重新登录时，也必须使用本技能。
| name | grok-oauth-router |
| description | 统一使用 Grok 完成聊天、推理、X 搜索、图片生成、视频生成、文本转语音、语音转文字和代理接入的能力路由技能。只要用户明确说“用 Grok”“走 Grok OAuth”“用 xAI/Grok 做某件事”，或者上下文明显要求把任务交给 Grok 处理时，就应该触发本技能。遇到未登录、令牌失效、需要先完成 OAuth 再恢复原任务、或需要区分 entitlement 拒绝与重新登录时，也必须使用本技能。 |
这个技能的目标不是单纯解释 Grok OAuth，也不是只把模型切换到 Grok。
你的职责是把用户的“用 Grok 做 X”转换成一个可执行的完整流程：
默认使用用户自己的 OAuth。
默认坚持 OAuth-first。不要静默退回 API key 模式。只有在用户明确允许时， 才把 API key 作为异常回退路径。
当出现下面这些情况时，应当触发本技能：
高频示例：
先把用户任务归类到以下内部模式之一：
chatx_searchimage_genvideo_genttssttproxy归类原则：
chat 处理x_searchimage_genvideo_genttssttproxy始终按下面的顺序处理：
不要一看到 Grok 就只讨论认证。先提炼出用户真正想完成的任务。
你需要在内部保留一个简短的“原始任务摘要”，用于认证完成后的自动续跑。
优先复用已有的 Grok OAuth 状态。检查重点包括：
如果 OAuth 已可用，就直接继续执行原始任务。
如果没有可用 OAuth，就先完成认证，再继续任务。
认证模式优先级：
认证完成后要做两件事：
认证通过后，按能力类型继续：
chat
用 Grok 作为主模型完成聊天、推理、分析、总结、工具调用等任务
x_search
优先使用 Grok 的 X 搜索能力，而不是泛化成普通网页搜索
image_gen
路由到 Grok 图片生成能力
video_gen
路由到 Grok 视频生成能力
tts
路由到 Grok 文本转语音能力
stt
路由到 Grok 语音转文字能力
proxy
路由到 Grok 兼容代理能力
认证只是前置步骤，不是结果。
认证成功后，直接继续执行原始任务，不要要求用户重复说一遍“刚才那个任务”。
必须区分两类问题：
这类问题通常意味着：
遇到这种情况时，应该把重点放在“先完成认证，再自动恢复原任务”。
这类问题不是简单重新登录就能解决的。
当判断为 entitlement、tier、allowlist 或 API 权限被拒绝时：
如果某个 Grok 模型不支持 x_search 或某个工具能力：
与用户沟通时遵守下面的规则：
如果认证会打断当前执行，应当明确保留原始任务语义，例如：
优先按需读取以下文档：
./grok-skill-routing-plan.md
用于理解整体设计目标、路由边界和运行时状态机
./capability-matrix.md
用于确认当前 Grok 能力面和路由范围
./oauth-flow.md
用于理解 OAuth 的用户路径、本地 / SSH / manual-paste 分支，以及恢复原任务的要求
./constraints-and-risks.md
用于判断哪些情况属于能力限制、上游变化或路由风险
./hermes-grok-oauth-parameter-observations.md
只在需要研究兼容性细节时读取。这里记录的是 Hermes 当前可观察到的参数、
固定值和行为特征，用于兼容性判断，而不是稳定不变的官方契约。
需要理解下面这个边界：
在真正需要分析兼容性问题时，再去查阅参数观察文档。
当任务完成时：
当任务被认证阻塞时：
当任务被 entitlement 阻塞时：
用户：用 Grok 帮我总结这个仓库的核心架构。
你的处理：
chat用户：用 Grok 去 X 上搜一下大家对 Grok 新功能的反应。
你的处理：
x_search用户：用 Grok 生成一张复古未来主义风格的产品海报。
你的处理：
image_gen