TanStack · AlemTuzlak · Jun 4, 2026 · Jun 4, 2026
diff --git a/.changeset/provider-skills.md b/.changeset/provider-skills.md
diff --git a/packages/ai-anthropic/CHANGELOG.md b/packages/ai-anthropic/CHANGELOG.md
@@ -1,5 +1,21 @@
 # @tanstack/ai-anthropic
 
+## 0.15.0
+
+### Minor Changes
+
+- [#695](https://github.com/TanStack/ai/pull/695) [`786b3e4`](https://github.com/TanStack/ai/commit/786b3e4d68815349f3157bdfea1791038c978519) - feat: attach hosted provider Skills to code-execution / shell tools
+
+  Hosted, provider-managed Agent Skills can now be attached to the server-side execution tool that runs them:
+  - **Anthropic** — `codeExecutionTool(config, { skills: [{ type: 'anthropic', skill_id: 'pptx', version: 'latest' }] })`. The adapter lifts the skills into the request's top-level `container.skills` and automatically attaches the required beta headers (`code-execution-2025-08-25` — or `code-execution-2025-05-22` for the legacy `code_execution_20250522` variant — plus `skills-2025-10-02`).
+  - **OpenAI** — `shellTool({ environment: { type: 'container_auto', skills: [{ type: 'skill_reference', skill_id: '...', version: '2' }] } })`, threaded through the Responses API shell tool.
+
+  Scope: hosted/managed skills referenced by id + version. Skills are inert without the execution tool that runs them.
+
+  Setting skills via Anthropic's `modelOptions.container.skills` is deprecated in favor of `codeExecutionTool(config, { skills })`.
+
+  Bumps the `openai` SDK to `^6.41.0` (required for the typed shell `environment.skills` surface).
+
 ## 0.14.0
 
 ### Minor Changes

diff --git a/packages/ai-anthropic/package.json b/packages/ai-anthropic/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-anthropic",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "Anthropic Claude adapter for TanStack AI chat, tool calling, thinking, and structured outputs.",
   "author": "",
   "license": "MIT",

diff --git a/packages/ai-grok/CHANGELOG.md b/packages/ai-grok/CHANGELOG.md
@@ -1,5 +1,24 @@
 # @tanstack/ai-grok
 
+## 0.11.1
+
+### Patch Changes
+
+- [#695](https://github.com/TanStack/ai/pull/695) [`786b3e4`](https://github.com/TanStack/ai/commit/786b3e4d68815349f3157bdfea1791038c978519) - feat: attach hosted provider Skills to code-execution / shell tools
+
+  Hosted, provider-managed Agent Skills can now be attached to the server-side execution tool that runs them:
+  - **Anthropic** — `codeExecutionTool(config, { skills: [{ type: 'anthropic', skill_id: 'pptx', version: 'latest' }] })`. The adapter lifts the skills into the request's top-level `container.skills` and automatically attaches the required beta headers (`code-execution-2025-08-25` — or `code-execution-2025-05-22` for the legacy `code_execution_20250522` variant — plus `skills-2025-10-02`).
+  - **OpenAI** — `shellTool({ environment: { type: 'container_auto', skills: [{ type: 'skill_reference', skill_id: '...', version: '2' }] } })`, threaded through the Responses API shell tool.
+
+  Scope: hosted/managed skills referenced by id + version. Skills are inert without the execution tool that runs them.
+
+  Setting skills via Anthropic's `modelOptions.container.skills` is deprecated in favor of `codeExecutionTool(config, { skills })`.
+
+  Bumps the `openai` SDK to `^6.41.0` (required for the typed shell `environment.skills` surface).
+
+- Updated dependencies [[`786b3e4`](https://github.com/TanStack/ai/commit/786b3e4d68815349f3157bdfea1791038c978519)]:
+  - @tanstack/openai-base@0.8.0
+
 ## 0.11.0
 
 ### Minor Changes

diff --git a/packages/ai-grok/package.json b/packages/ai-grok/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-grok",
-  "version": "0.11.0",
+  "version": "0.11.1",
   "description": "xAI Grok adapter for TanStack AI chat, image generation, realtime, and structured outputs.",
   "author": "",
   "license": "MIT",

diff --git a/packages/ai-groq/CHANGELOG.md b/packages/ai-groq/CHANGELOG.md
@@ -1,5 +1,24 @@
 # @tanstack/ai-groq
 
+## 0.4.1
+
+### Patch Changes
+
+- [#695](https://github.com/TanStack/ai/pull/695) [`786b3e4`](https://github.com/TanStack/ai/commit/786b3e4d68815349f3157bdfea1791038c978519) - feat: attach hosted provider Skills to code-execution / shell tools
+
+  Hosted, provider-managed Agent Skills can now be attached to the server-side execution tool that runs them:
+  - **Anthropic** — `codeExecutionTool(config, { skills: [{ type: 'anthropic', skill_id: 'pptx', version: 'latest' }] })`. The adapter lifts the skills into the request's top-level `container.skills` and automatically attaches the required beta headers (`code-execution-2025-08-25` — or `code-execution-2025-05-22` for the legacy `code_execution_20250522` variant — plus `skills-2025-10-02`).
+  - **OpenAI** — `shellTool({ environment: { type: 'container_auto', skills: [{ type: 'skill_reference', skill_id: '...', version: '2' }] } })`, threaded through the Responses API shell tool.
+
+  Scope: hosted/managed skills referenced by id + version. Skills are inert without the execution tool that runs them.
+
+  Setting skills via Anthropic's `modelOptions.container.skills` is deprecated in favor of `codeExecutionTool(config, { skills })`.
+
+  Bumps the `openai` SDK to `^6.41.0` (required for the typed shell `environment.skills` surface).
+
+- Updated dependencies [[`786b3e4`](https://github.com/TanStack/ai/commit/786b3e4d68815349f3157bdfea1791038c978519)]:
+  - @tanstack/openai-base@0.8.0
+
 ## 0.4.0
 
 ### Minor Changes

diff --git a/packages/ai-groq/package.json b/packages/ai-groq/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-groq",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "type": "module",
   "description": "Groq adapter for TanStack AI low-latency chat, tool calling, and structured outputs.",
   "author": "",

diff --git a/packages/ai-openai/CHANGELOG.md b/packages/ai-openai/CHANGELOG.md
@@ -1,5 +1,26 @@
 # @tanstack/ai-openai
 
+## 0.14.0
+
+### Minor Changes
+
+- [#695](https://github.com/TanStack/ai/pull/695) [`786b3e4`](https://github.com/TanStack/ai/commit/786b3e4d68815349f3157bdfea1791038c978519) - feat: attach hosted provider Skills to code-execution / shell tools
+
+  Hosted, provider-managed Agent Skills can now be attached to the server-side execution tool that runs them:
+  - **Anthropic** — `codeExecutionTool(config, { skills: [{ type: 'anthropic', skill_id: 'pptx', version: 'latest' }] })`. The adapter lifts the skills into the request's top-level `container.skills` and automatically attaches the required beta headers (`code-execution-2025-08-25` — or `code-execution-2025-05-22` for the legacy `code_execution_20250522` variant — plus `skills-2025-10-02`).
+  - **OpenAI** — `shellTool({ environment: { type: 'container_auto', skills: [{ type: 'skill_reference', skill_id: '...', version: '2' }] } })`, threaded through the Responses API shell tool.
+
+  Scope: hosted/managed skills referenced by id + version. Skills are inert without the execution tool that runs them.
+
+  Setting skills via Anthropic's `modelOptions.container.skills` is deprecated in favor of `codeExecutionTool(config, { skills })`.
+
+  Bumps the `openai` SDK to `^6.41.0` (required for the typed shell `environment.skills` surface).
+
+### Patch Changes
+
+- Updated dependencies [[`786b3e4`](https://github.com/TanStack/ai/commit/786b3e4d68815349f3157bdfea1791038c978519)]:
+  - @tanstack/openai-base@0.8.0
+
 ## 0.13.0
 
 ### Minor Changes

diff --git a/packages/ai-openai/package.json b/packages/ai-openai/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-openai",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "OpenAI adapter for TanStack AI chat, tools, images, video, speech, transcription, realtime, and structured outputs.",
   "author": "",
   "license": "MIT",

diff --git a/packages/openai-base/CHANGELOG.md b/packages/openai-base/CHANGELOG.md
@@ -1,5 +1,21 @@
 # @tanstack/openai-base
 
+## 0.8.0
+
+### Minor Changes
+
+- [#695](https://github.com/TanStack/ai/pull/695) [`786b3e4`](https://github.com/TanStack/ai/commit/786b3e4d68815349f3157bdfea1791038c978519) - feat: attach hosted provider Skills to code-execution / shell tools
+
+  Hosted, provider-managed Agent Skills can now be attached to the server-side execution tool that runs them:
+  - **Anthropic** — `codeExecutionTool(config, { skills: [{ type: 'anthropic', skill_id: 'pptx', version: 'latest' }] })`. The adapter lifts the skills into the request's top-level `container.skills` and automatically attaches the required beta headers (`code-execution-2025-08-25` — or `code-execution-2025-05-22` for the legacy `code_execution_20250522` variant — plus `skills-2025-10-02`).
+  - **OpenAI** — `shellTool({ environment: { type: 'container_auto', skills: [{ type: 'skill_reference', skill_id: '...', version: '2' }] } })`, threaded through the Responses API shell tool.
+
+  Scope: hosted/managed skills referenced by id + version. Skills are inert without the execution tool that runs them.
+
+  Setting skills via Anthropic's `modelOptions.container.skills` is deprecated in favor of `codeExecutionTool(config, { skills })`.
+
+  Bumps the `openai` SDK to `^6.41.0` (required for the typed shell `environment.skills` surface).
+
 ## 0.7.0
 
 ### Minor Changes

diff --git a/packages/openai-base/package.json b/packages/openai-base/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/openai-base",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Shared OpenAI SDK base adapters for TanStack AI providers using Chat Completions and Responses APIs.",
   "author": "",
   "license": "MIT",