> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tilebox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Skills

> Install Tilebox skills that teach AI agents how to work with Tilebox tools and workflows.

export const AgentPrompt = ({children}) => {
  return <div className="tilebox-agent-chat" aria-label="Example agent chat prompt">
      <div className="tilebox-agent-chat-message">
        <div className="tilebox-agent-chat-avatar" aria-hidden="true">
          <Icon icon="user" iconType="solid" />
        </div>
        <div className="tilebox-agent-chat-content">
          <div className="tilebox-agent-chat-meta">You</div>
          <div className="tilebox-agent-chat-bubble">
            {children}
          </div>
        </div>
      </div>
    </div>;
};

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 and the CLI

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 theme={"system"}
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 theme={"system"}
npx skills add tilebox/skills
```

<Columns cols={1}>
  <Card title="Tilebox skills on GitHub" icon="github" href="https://github.com/tilebox/skills" horizontal>
    Browse the source repository for the Tilebox agent skills.
  </Card>
</Columns>

After installation, your agent can load the relevant skill before working on a Tilebox task.

## Included skills

Tilebox skills cover common agent workflows around the CLI, datasets, workflows, jobs, and automations.

| Skill                              | What it covers                                                                                                                                                  |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `using-tilebox-cli`                | Authentication, `--json`, `jq`, `agent-context`, and documentation search                                                                                       |
| `managing-tilebox-datasets`        | Creating schemas, updating metadata, and querying datasets                                                                                                      |
| `managing-tilebox-jobs`            | Submitting jobs, monitoring status, reading logs, and inspecting spans                                                                                          |
| `working-with-tilebox-automations` | Working with triggers, automations, and storage locations                                                                                                       |
| `writing-tilebox-workflows`        | Writing workflow task classes, task graphs, runner definitions, caches, logs, and spans                                                                         |
| `releasing-tilebox-workflows`      | Initializing workflow projects, configuring `tilebox.workflow.toml`, building releases, publishing releases, deploying to clusters, and running release runners |

## How to use skills with agents

Ask your agent to load the most specific Tilebox skill for the task. For example, use `managing-tilebox-datasets` for schema work and `managing-tilebox-jobs` for workflow execution or observability tasks.

<AgentPrompt>
  Load the relevant Tilebox skills. Use the Tilebox CLI to submit a Sentinel-2 mosaic job, then monitor it until it completes.
</AgentPrompt>

Skills work best with the Tilebox CLI. The CLI gives the agent repeatable terminal commands, and skills tell it how to combine those commands safely. Use MCP as an alternative when the agent runs in a web or chat environment without practical terminal access.

For Python workflow release work, ask the agent to use both `writing-tilebox-workflows` and `releasing-tilebox-workflows`. For a new project, the typical loop starts with `tilebox workflow init`. After that, the agent edits tasks, builds a release, publishes it, deploys it to a development cluster, runs `tilebox runner start`, submits a test job, and inspects logs or spans before iterating.