Documentation 2026-08-11 17:57 UTC to 2026-08-12 16:01 UTC

15 15 

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

17 17 

18`SKILL.md` starts with YAML frontmatter. Extra keys are ignored.

19 

20| Field | Description |

21| ----- | ----------- |

22| `name` | Identifier. Directory name if omitted. |

23| `description` | What it does and when to use it. First body paragraph if omitted. |

24| `when-to-use` | Extra trigger phrases. Alias: `when_to_use`. |

25| `paths` | Gitignore globs. Hidden until a matching file is touched. |

26| `allowed-tools` | Does not grant or restrict tools. Accepts a YAML list or a comma/space-separated string. |

27| `argument-hint` | Slash-command autocomplete hint. |

28| `user-invocable` | Show as a slash command. Default `true`. `false` hides it from you and from the model. Only the literal `true` counts; `yes` is false. |

29| `disable-model-invocation` | Slash command only; no automatic invoke. Default `false`. |

30| `metadata` | String map. `author` and `short-description` are shown in the UI. |

31 

32Grok accepts `model`, `effort`, `license`, and `compatibility` and does not apply them.

33 

18## Plugins34## Plugins

19 35 

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

70 70 

71You can also switch inside the TUI with `/model <name>`.71You can also switch inside the TUI with `/model <name>`.

72 72 

73## Use Grok 4.5 on the API73## Use Grok 4.6 on the API

74 74 

75The same model that powers Grok Build, [`grok-4.5`](/developers/models/grok-4.5), is also available directly on the xAI API. Drop it into your own agent loop, IDE integration, or coding tool.75The same model that powers Grok Build, [`grok-4.6`](/developers/models/grok-4.6), is also available directly on the xAI API. Drop it into your own agent loop, IDE integration, or coding tool.

76 76 

77```bash customLanguage="bash"77```bash customLanguage="bash"

78curl https://api.x.ai/v1/responses \78curl https://api.x.ai/v1/responses \

79 -H "Authorization: Bearer $XAI_API_KEY" \79 -H "Authorization: Bearer $XAI_API_KEY" \

80 -H "Content-Type: application/json" \80 -H "Content-Type: application/json" \

81 -d '{81 -d '{

82 "model": "grok-4.5",82 "model": "grok-4.6",

83 "input": "Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}"83 "input": "Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}"

84 }'84 }'

85```85```

91 91 

92client = Client(api_key=os.getenv("XAI_API_KEY"))92client = Client(api_key=os.getenv("XAI_API_KEY"))

93 93 

94chat = client.chat.create(model="grok-4.5")94chat = client.chat.create(model="grok-4.6")

95chat.append(user("Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}"))95chat.append(user("Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}"))

96 96 

97print(chat.sample().content)97print(chat.sample().content)

106)106)

107 107 

108response = client.responses.create(108response = client.responses.create(

109 model="grok-4.5",109 model="grok-4.6",

110 input="Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}",110 input="Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}",

111)111)

112 112 

118import { generateText } from 'ai';118import { generateText } from 'ai';

119 119 

120const { text } = await generateText({120const { text } = await generateText({

121 model: xai.responses('grok-4.5'),121 model: xai.responses('grok-4.6'),

122 prompt: 'Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}',122 prompt: 'Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}',

123});123});

124 124 

33```toml customLanguage="toml"33```toml customLanguage="toml"

34[models]34[models]

35default = "grok-build" # recommended for coding / agent sessions35default = "grok-build" # recommended for coding / agent sessions

36web_search = "grok-4.5" # model used by client-side web_search tool36web_search = "grok-4.6" # model used by client-side web_search tool

37 37 

38[model."grok-4.5"]38[model."grok-4.6"]

39model = "grok-4.5" # id sent to the API39model = "grok-4.6" # id sent to the API

40base_url = "https://api.x.ai/v1" # provider endpoint40base_url = "https://api.x.ai/v1" # provider endpoint

41name = "Grok 4.5" # shown in model picker41name = "Grok 4.6" # shown in model picker

42description = "Grok 4.5 from xAI"42description = "Grok 4.6 from xAI"

43env_key = "XAI_API_KEY" # env var holding the API key43env_key = "XAI_API_KEY" # env var holding the API key

44api_backend = "responses" # chat_completions | responses | messages44api_backend = "responses" # chat_completions | responses | messages

45temperature = 0.745temperature = 0.7