tilebox · lukasbindreiter · Jun 25, 2026 · Jun 25, 2026
diff --git a/agent-onboarding.mdx b/agent-onboarding.mdx
@@ -8,18 +8,17 @@ If you are using ChatGPT or claude.ai, stop. Tell the user to switch to Codex or
 
 Get the agent ready to use Tilebox from the terminal:
 
-1. Install the Tilebox CLI.
-2. Install the Tilebox skills.
-3. Help the user create an API key.
-4. Give the user the exact shell command to set `TILEBOX_API_KEY` and reload their current environment.
-5. Verify read-only setup. Do not change Tilebox resources.
+1. Install the Tilebox CLI and Agent Skills.
+2. Help the user create an API key.
+3. Give the user the exact shell command to set `TILEBOX_API_KEY` and reload their current environment.
+4. Verify read-only setup. Do not change Tilebox resources.
 
-## Step 1: install the Tilebox CLI
+## Step 1: install the Tilebox CLI and Agent Skills
 
 Run:
 
 ```bash
-curl -fsSL https://cli.tilebox.com/install.sh | sh
+curl -fsSL https://install.tilebox.com/wizard.sh | sh
 ```
 
 Then verify:
@@ -35,17 +34,9 @@ If `tilebox` is not on `PATH`, use the default installed path directly:
 $HOME/.local/bin/tilebox --help
 ```
 
-## Step 2: install Tilebox skills
+Confirm the Tilebox skills are present in the user's skills directory.
 
-Run:
-
-```bash
-npx skills add tilebox/skills --yes --global
-```
-
-Then confirm the Tilebox skills are present in the user's skills directory.
-
-## Step 3: ask the user for an API key
+## Step 2: ask the user for an API key
 
 Send the user here:
 
@@ -57,7 +48,7 @@ Ask them to create a key with the smallest permissions needed for their task.
 
 Do not ask them to paste the key into chat unless there is no safer option. Prefer that they run a command in their own terminal.
 
-## Step 4: give the exact command for their shell
+## Step 3: give the exact command for their shell
 
 Detect the user's shell with:
 
@@ -97,7 +88,7 @@ Fish universal variables apply to new shells automatically. For the current shel
 set -gx TILEBOX_API_KEY "YOUR_TILEBOX_API_KEY"
 ```
 
-## Step 5: verify safely
+## Step 4: verify safely
 
 Run read-only checks only:
 

diff --git a/agents-and-ai-tools/agent-skills.mdx b/agents-and-ai-tools/agent-skills.mdx
@@ -8,9 +8,16 @@ import { AgentPrompt } from '/snippets/components.mdx';
 
 Tilebox skills are task-level instructions for AI agents. They explain how to use the Tilebox CLI, which command patterns to prefer, and how to approach common workflows such as dataset management and job monitoring.
 
-## Install Tilebox skills
+## Install Tilebox skills and the CLI
 
-Install the skills from the Tilebox skills repository.
+Many skill operations require the [Tilebox CLI](/agents-and-ai-tools/tilebox-cli),
+which is why it's recommended to use our installation wizard that sets up both Skills and the CLI on your system.
+
+```bash
+curl -fsSL https://install.tilebox.com/wizard.sh | sh
+```
+
+If you want to customize the skill installation directory, or select just a subset of the skills to install, you can use
 
 ```bash
 npx skills add tilebox/skills

diff --git a/agents-and-ai-tools/tilebox-cli.mdx b/agents-and-ai-tools/tilebox-cli.mdx
@@ -13,9 +13,17 @@ The CLI is also the default Tilebox interface for coding agents that can run ter
 Install the Tilebox CLI with the install script.
 
 ```bash
-curl -fsSL https://cli.tilebox.com/install.sh | sh
+curl -fsSL https://install.tilebox.com/cli.sh | sh
 ```
 
+<Tip>
+If you want to install the Tilebox CLI and Agent Skills together, use the setup wizard instead.
+
+```bash
+curl -fsSL https://install.tilebox.com/wizard.sh | sh
+```
+</Tip>
+
 ## Authenticate
 
 The CLI reads the `TILEBOX_API_KEY` environment variable. Create an API key in the [Tilebox Console](https://console.tilebox.com/settings/api-keys), then export it in the shell or agent environment that runs CLI commands.
@@ -76,7 +84,7 @@ This pattern is safer for agents because generated JSON, geometry, and descripti
 The Tilebox skills include guidance for using the CLI in agent workflows. Install them when you want an agent to combine CLI commands into higher-level tasks such as managing datasets, monitoring jobs, or configuring automations.
 
 ```bash
-npx skills add tilebox/skills
+curl -fsSL https://install.tilebox.com/skills.sh | sh
 ```
 
 After installing the skills, ask your agent to inspect `tilebox agent-context` and follow the relevant Tilebox skill before running commands that change resources. If your agent cannot use a terminal, configure the [Tilebox MCP server](/agents-and-ai-tools/tilebox-mcp) instead.
diff --git a/guides/workflows/agentic-workflow-iteration.mdx b/guides/workflows/agentic-workflow-iteration.mdx
@@ -15,9 +15,8 @@ Use this loop when you want the code under test to match the artifact that relea
 Set up the Tilebox command-line tool and skills in the environment where your agent runs.
 
 ```bash
-curl -fsSL https://cli.tilebox.com/install.sh | sh
+curl -fsSL https://install.tilebox.com/wizard.sh | sh
 export TILEBOX_API_KEY="YOUR_TILEBOX_API_KEY"
-npx skills add tilebox/skills
 ```
 
 Ask the agent to inspect the command-line tool before changing resources.

diff --git a/guides/workflows/deploy-to-your-compute.mdx b/guides/workflows/deploy-to-your-compute.mdx
@@ -64,7 +64,7 @@ RUN apt-get update && apt-get install -y --no-install-recommends ca-certificates
     && rm -rf /var/lib/apt/lists/* \
     && apt-get clean
 
-RUN curl -fsSL https://cli.tilebox.com/install.sh | TILEBOX_INSTALL_DIR=/usr/local/bin TILEBOX_NO_INSTALL_COMPLETIONS=1 sh
+RUN curl -fsSL https://install.tilebox.com/cli.sh | TILEBOX_INSTALL_DIR=/usr/local/bin TILEBOX_NO_INSTALL_COMPLETIONS=1 sh
 
 # Required at runtime: set TILEBOX_CLUSTER to a valid cluster slug and
 # TILEBOX_API_KEY to an API key that can read deployments and claim tasks.

diff --git a/index.mdx b/index.mdx
@@ -123,7 +123,7 @@ export const HomeSearch = () => {
               </div>
               <div className="tilebox-cli-code">
 ```bash CLI wrap
-curl -fsSL https://cli.tilebox.com/install.sh | sh
+curl -fsSL https://install.tilebox.com/cli.sh | sh
 
 tilebox dataset query
   open_data.copernicus.sentinel2_msi

diff --git a/onboard-your-agent.mdx b/onboard-your-agent.mdx
@@ -14,7 +14,7 @@ on this page, and follow the agent-onboarding guide instead, which was designed
 this purpose.
 </div>
 
-Onboard your AI agent to Tilebox, by installing the Tilebox CLI, installing Tilebox Agent skills and configuring your API Key. After completing it, your agent will be able to manage your Tilebox resources, and use Tilebox-specific skills to create and query datasets, submit and monitor jobs.
+Onboard your AI agent to Tilebox by installing the Tilebox CLI and Agent Skills, then configuring your API key. After completing it, your agent will be able to manage your Tilebox resources and use Tilebox-specific skills to create and query datasets, submit and monitor jobs.
 It will also be able to write geospatial workflows, deploy it to clusters, submit jobs and iterate on the workflow code after inspecting job logs and checking outputs.
 If you want to use Tilebox directly as a developer, start with the [developer quickstart](/quickstart).
 
@@ -24,14 +24,14 @@ If you want to integrate Tilebox into your LLM Chat interface, rather than your
 </Tip>
 
 <Steps>
-  <Step title="Install the Tilebox CLI">
-    Install the Tilebox CLI with the install script.
+  <Step title="Install the Tilebox CLI and Agent Skills">
+    Install the Tilebox CLI and Tilebox Agent Skills with the setup wizard.
 
     ```bash
-    curl -fsSL https://cli.tilebox.com/install.sh | sh
+    curl -fsSL https://install.tilebox.com/wizard.sh | sh
     ```
 
-    The CLI is the default interface for coding agents because it works in the same terminal where the agent edits files, runs tests, and applies changes.
+    The CLI is the default interface for coding agents because it works in the same terminal where the agent edits files, runs tests, and applies changes. The skills add task-level instructions for CLI usage, dataset management, job monitoring, workflow authoring, and automations.
   </Step>
   <Step title="Authenticate the CLI">
     Set `TILEBOX_API_KEY` in the environment where your agent runs. You can create an API key in the [Tilebox Console](https://console.tilebox.com/settings/api-keys).
@@ -42,15 +42,6 @@ If you want to integrate Tilebox into your LLM Chat interface, rather than your
 
     Use a key with the smallest permissions needed for the task you want the agent to perform.
   </Step>
-  <Step title="Install Tilebox skills">
-    Install the Tilebox skills so your agent has task-level instructions for working with the CLI and Tilebox resources.
-
-    ```bash
-    npx skills add tilebox/skills
-    ```
-
-    The skills cover CLI usage, dataset management, job monitoring, workflow authoring, and automations.
-  </Step>
   <Step title="Verify the setup">
     Ask your agent to inspect its Tilebox capabilities before assigning a larger task.
 

diff --git a/sdks/go/install.mdx b/sdks/go/install.mdx
@@ -28,5 +28,5 @@ go get github.com/tilebox/tilebox-go
 Install the Tilebox command-line tool on your machine.
 
 ```bash Shell
-curl -fsSL https://cli.tilebox.com/install.sh | sh
+curl -fsSL https://install.tilebox.com/cli.sh | sh
 ```