# Agent Skills

Agent skills are reusable knowledge modules that AI coding agents can use to work with Tigris correctly. When installed, skills give agents procedural knowledge about Tigris — how to set up storage, manage buckets, handle objects, and more — without you needing to prompt them through each step.

Skills work with Claude Code, Cursor, GitHub Copilot, Cline, Gemini, and other agents that support the [skills.sh](https://skills.sh) ecosystem.

## Install Skills[​](#install-skills "Direct link to Install Skills")

Install all Tigris skills at once:

```
npx skills add tigrisdata/skills
```

Or install a single skill:

```
npx skills add tigrisdata/skills --skill file-storage
```

Browse the full list at [skills.sh/tigrisdata/skills](https://skills.sh/tigrisdata/skills).

## Available Skills[​](#available-skills "Direct link to Available Skills")

Each skill links to its pattern page. The pattern pages are generated from the [tigrisdata/skills](https://github.com/tigrisdata/skills) repository. For the full list, see [Tigris Agent Skill Patterns](https://www.tigrisdata.com/docs/ai-agents/skills.md).

### Storage Setup[​](#storage-setup "Direct link to Storage Setup")

| Skill                                                                                          | Description                                                                |
| ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| [**file-storage**](https://www.tigrisdata.com/docs/ai-agents/skills/file-storage.md)           | CLI setup, access keys, and the `@tigrisdata/storage` SDK for file uploads |
| [**tigris-sdk-guide**](https://www.tigrisdata.com/docs/ai-agents/skills/tigris-sdk-guide.md)   | Which SDK to use per language, and when to use an AWS SDK                  |
| [**tigris-python-sdk**](https://www.tigrisdata.com/docs/ai-agents/skills/tigris-python-sdk.md) | Python with boto3 and `tigris-boto3-ext`, including Django uploads         |

### Object Operations[​](#object-operations "Direct link to Object Operations")

| Skill                                                                                                          | Description                                                         |
| -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| [**tigris-object-operations**](https://www.tigrisdata.com/docs/ai-agents/skills/tigris-object-operations.md)   | Upload, download, delete, list objects, and generate presigned URLs |
| [**tigris-image-optimization**](https://www.tigrisdata.com/docs/ai-agents/skills/tigris-image-optimization.md) | Image processing and optimization with Tigris                       |
| [**tigris-static-assets**](https://www.tigrisdata.com/docs/ai-agents/skills/tigris-static-assets.md)           | Serving and managing static assets                                  |

### Bucket Management[​](#bucket-management "Direct link to Bucket Management")

| Skill                                                                                                                    | Description                                         |
| ------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------- |
| [**tigris-bucket-management**](https://www.tigrisdata.com/docs/ai-agents/skills/tigris-bucket-management.md)             | Create, list, inspect, and remove buckets           |
| [**tigris-lifecycle-management**](https://www.tigrisdata.com/docs/ai-agents/skills/tigris-lifecycle-management.md)       | Object lifecycle policies and expiration rules      |
| [**tigris-security-access-control**](https://www.tigrisdata.com/docs/ai-agents/skills/tigris-security-access-control.md) | Bucket permissions and access control configuration |

### Snapshots, Forks & Migration[​](#snapshots-forks--migration "Direct link to Snapshots, Forks & Migration")

| Skill                                                                                                          | Description                                            |
| -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
| [**tigris-snapshots-forking**](https://www.tigrisdata.com/docs/ai-agents/skills/tigris-snapshots-forking.md)   | Point-in-time bucket snapshots and copy-on-write forks |
| [**tigris-snapshots-recovery**](https://www.tigrisdata.com/docs/ai-agents/skills/tigris-snapshots-recovery.md) | Restore data from snapshots                            |
| [**tigris-s3-migration**](https://www.tigrisdata.com/docs/ai-agents/skills/tigris-s3-migration.md)             | Migrate from AWS S3 or other S3-compatible providers   |
| [**tigris-backup-export**](https://www.tigrisdata.com/docs/ai-agents/skills/tigris-backup-export.md)           | Backup and export procedures                           |

### Optimization[​](#optimization "Direct link to Optimization")

| Skill                                                                                                      | Description                                    |
| ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
| [**tigris-egress-optimizer**](https://www.tigrisdata.com/docs/ai-agents/skills/tigris-egress-optimizer.md) | Reduce data transfer costs and optimize egress |

### Agent Workflows[​](#agent-workflows "Direct link to Agent Workflows")

| Skill                                                                                        | Description                                                        |
| -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| [**tigris-agent-kit**](https://www.tigrisdata.com/docs/ai-agents/skills/tigris-agent-kit.md) | Forks, workspaces, checkpoints, and coordination for agent storage |
| [**openclaw-backup**](https://www.tigrisdata.com/docs/ai-agents/skills/openclaw-backup.md)   | Back up and restore OpenClaw assistant state to a bucket           |

### Development Practices[​](#development-practices "Direct link to Development Practices")

| Skill                                                                                                  | Description                          |
| ------------------------------------------------------------------------------------------------------ | ------------------------------------ |
| [**conventional-commits**](https://www.tigrisdata.com/docs/ai-agents/skills/conventional-commits.md)   | Consistent commit message formatting |
| [**go-table-driven-tests**](https://www.tigrisdata.com/docs/ai-agents/skills/go-table-driven-tests.md) | Idiomatic Go test patterns           |

## How Skills Work[​](#how-skills-work "Direct link to How Skills Work")

Once installed, skills are stored as markdown files in your agent's configuration directory. For example, Claude Code reads skills from `~/.claude/skills/`. When you ask your agent to perform a storage task, it automatically recognizes when a skill applies and uses that knowledge to produce correct code.

For example, with the **tigris-object-operations** skill installed, asking an agent to "add an avatar upload endpoint" produces code that handles multipart uploads correctly, includes proper error checking, and uses Tigris best practices — without you needing to specify those details.

## Skills vs Context Files[​](#skills-vs-context-files "Direct link to Skills vs Context Files")

Skills and context files serve different purposes:

|              | Skills                                  | Context Files                                                                                 |
| ------------ | --------------------------------------- | --------------------------------------------------------------------------------------------- |
| **Scope**    | Global — available across all projects  | Project-specific (`TIGRIS.md`) or machine-wide (`SKILL.md`)                                   |
| **Content**  | Procedural knowledge for specific tasks | Configuration and conventions for your setup                                                  |
| **Install**  | `npx skills add` from skills.sh         | Added to your repo or installed with the [Tigris CLI](https://www.tigrisdata.com/docs/cli.md) |
| **Best for** | Teaching agents *how* to use Tigris     | Telling agents *your* Tigris configuration                                                    |

Use both together for best results: skills teach agents Tigris patterns, and context files tell agents your specific setup.

## Learn More[​](#learn-more "Direct link to Learn More")

* [MCP Server](https://www.tigrisdata.com/docs/mcp.md) — structured tool access for agents that support the Model Context Protocol
* [Tigris CLI](https://www.tigrisdata.com/docs/cli.md) — install the CLI to get a global `SKILL.md` context file for your agents
* [skills.sh/tigrisdata/skills](https://skills.sh/tigrisdata/skills) — browse and install individual skills
* [Tigris Agent Skill Patterns](https://www.tigrisdata.com/docs/ai-agents/skills.md) — read each skill as a pattern page
