tigris-bucket-management — скилл для Claude Code: установка и обзор
Скилл tigris-bucket-management помогает управлять бакетами в Tigris Storage: создавать публичные или приватные хранилища, настраивать регионы, проверять свойства и удалять корзины.
MIT 135 установок ★ 2 обновлён 2026-07-23
npx skills add tigrisdata/skills --skill tigris-bucket-management -a claude-codeЧто делает tigris-bucket-management
Скилл даёт агенту инструкции и типовые примеры кода на TypeScript для работы с хранилищем через библиотеку @tigrisdata/storage. С ним модель применяет функции createBucket, запрашивает списки бакетов с пагинацией через listBuckets, проверяет метаданные с помощью getBucketInfo и удаляет ресурсы вызовом removeBucket.
Перед выполнением операций требуется наличие интерфейса командной строки @tigrisdata/cli. Бакеты с включёнными снапшотами требуют уровня хранения STANDARD, а имена бакетов обязаны быть глобально уникальными.
Какие задачи решает
- создать приватный или публичный бакет в Tigris Storage
- настроить создание форка бакета из снапшота
- получить список бакетов с постраничной навигацией
- удалить пустой бакет или очистить занятый с флагом force
Примеры запросов агенту
- Создай публичный бакет public-assets в европейском регионе eu
- Покажи список всех бакетов в Tigris Storage с пагинацией
- Удали бакет old-data с параметром force: true
Как установить tigris-bucket-management
1Через Skills CLI (Vercel)
npx skills add tigrisdata/skills --skill tigris-bucket-management -a claude-code2Вручную: положить файлы
~/.claude/skills/tigris-bucket-management/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/tigris-bucket-management/
1Через Skills CLI (Vercel)
npx skills add tigrisdata/skills --skill tigris-bucket-management -a codex2Вручную: положить файлы
.agents/skills/tigris-bucket-management/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add tigrisdata/skills --skill tigris-bucket-management -a cursor2Вручную: положить файлы
.cursor/skills/tigris-bucket-management/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install tigrisdata/skills skills/tigris-bucket-management2Вручную: положить файлы
.github/skills/tigris-bucket-management/SKILL.md1Через Skills CLI (Vercel)
npx skills add tigrisdata/skills --skill tigris-bucket-management -a gemini-cli2Командой платформы
gemini skills install https://github.com/tigrisdata/skills --path skills/tigris-bucket-managementВручную: положить файлы
.devin/skills/tigris-bucket-management/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add tigrisdata/skills --skill tigris-bucket-management -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о tigris-bucket-management
Как установить tigris-bucket-management в Claude Code?
Выполните команду npx skills add tigrisdata/skills --skill tigris-bucket-management -a claude-code.
Что делает скилл tigris-bucket-management?
Он обучает агента управлять жизненным циклом бакетов Tigris Storage: создавать их с нужным уровнем доступа и регионом, проверять метаданные и удалять.
Что нужно подготовить перед началом работы?
Требуется установленная утилита @tigrisdata/cli, наличие которой можно проверить вызовом команды tigris help.
Исходный текст
SKILL.md · MIT
---
name: tigris-bucket-management
description: Use when creating, listing, inspecting, or deleting Tigris Storage buckets
---
# Tigris Bucket Management
## Prerequisites
**Before doing anything else**, install the Tigris CLI if it's not already available:
```bash
tigris help || npm install -g @tigrisdata/cli
```
If you need to install it, tell the user: "I'm installing the Tigris CLI (`@tigrisdata/cli`) so we can work with Tigris object storage."
## Overview
Buckets are containers for objects. This skill covers bucket lifecycle: create, list, inspect, and delete.
## Quick Reference
| Operation | Function | Key Parameters |
| --------- | ----------------------------- | ------------------------------------ |
| Create | `createBucket(name, options)` | name, access, region, enableSnapshot |
| List | `listBuckets(options)` | limit, paginationToken |
| Inspect | `getBucketInfo(name)` | bucketName |
| Delete | `removeBucket(name, options)` | bucketName, force |
## Create Bucket
```typescript
import { createBucket } from "@tigrisdata/storage";
// Simple private bucket
const result = await createBucket("my-new-bucket");
if (result.error) {
console.error("Error:", result.error);
} else {
console.log("Created:", result.data);
}
// Public bucket (objects readable by anyone)
const result = await createBucket("public-assets", {
access: "public",
});
// Snapshot-enabled bucket (for version control)
const result = await createBucket("my-snapshot-bucket", {
enableSnapshot: true,
});
// Regional bucket
const result = await createBucket("eu-data", {
region: "eu",
});
// Fork from existing bucket snapshot
const result = await createBucket("my-forked-bucket", {
sourceBucketName: "parent-bucket",
sourceBucketSnapshot: "1751631910169675092",
});
```
## Create Bucket Options
| Option | Values | Default | Purpose |
| -------------------- | --------------------------------------- | -------- | ------------------------ |
| access | public/private | private | Object readability |
| consistency | default/strict | default | Read consistency level |
| defaultTier | STANDARD/STANDARD_IA/GLACIER/GLACIER_IR | STANDARD | Default storage tier |
| enableSnapshot | boolean | false | Enable snapshots/forking |
| region | string | global | Bucket region |
| sourceBucketName | string | - | Fork from this bucket |
| sourceBucketSnapshot | string | - | Fork from this snapshot |
**Note:** Snapshot-enabled buckets must use STANDARD tier.
## List Buckets
```typescript
import { listBuckets } from "@tigrisdata/storage";
// List all buckets
const result = await listBuckets();
if (result.error) {
console.error("Error:", result.error);
} else {
console.log("Buckets:", result.data?.buckets);
console.log("Owner:", result.data?.owner);
}
// Paginated list
const allBuckets = [];
let currentPage = await listBuckets({ limit: 10 });
allBuckets.push(...currentPage.data?.buckets);
while (currentPage.data?.paginationToken) {
currentPage = await listBuckets({
limit: 10,
paginationToken: currentPage.data?.paginationToken,
});
allBuckets.push(...currentPage.data?.buckets);
}
```
## Get Bucket Info
```typescript
import { getBucketInfo } from "@tigrisdata/storage";
const result = await getBucketInfo("my-bucket");
if (result.error) {
console.error("Error:", result.error);
} else {
console.log("Info:", result.data);
// {
// isSnapshotEnabled: true,
// hasForks: false,
// sourceBucketName: undefined,
// sourceBucketSnapshot: undefined
// }
}
```
## Delete Bucket
```typescript
import { removeBucket } from "@tigrisdata/storage";
// Delete empty bucket
const result = await removeBucket("my-bucket");
if (result.error) {
console.error("Error:", result.error);
} else {
console.log("Deleted successfully");
}
// Force delete (even if not empty)
const result = await removeBucket("my-bucket", {
force: true,
});
```
**Warning:** Force delete is irreversible. All objects will be lost.
## Bucket Access Levels
| Level | Behavior | Use Case |
| ------- | ------------------------- | ----------------------------- |
| private | Objects require auth | Default, sensitive data |
| public | Objects publicly readable | Static assets, public content |
## Consistency Levels
| Level | Behavior | Trade-off |
| ------- | ---------------------------------- | -------------- |
| default | Low latency, eventual consistency | Most workloads |
| strict | Strong consistency, higher latency | Critical data |
## Storage Tiers
| Tier | Use Case | Cost |
| ----------- | --------------------------- | ------------------------------ |
| STANDARD | General purpose | Standard |
| STANDARD_IA | Infrequently accessed | Lower cost |
| GLACIER | Long-term archive | Lowest cost |
| GLACIER_IR | Rare access, fast retrieval | Archive with occasional access |
## Regions
Specify region for data locality or compliance:
```typescript
await createBucket("data-eu", { region: "eu" });
await createBucket("data-asia", { region: "asia-south-1" });
```
Leave empty for global bucket (recommended for most use cases).
## Common Mistakes
| Mistake | Fix |
| ----------------------------------------------- | -------------------------------------- |
| Enable snapshot with non-STANDARD tier | Snapshot requires STANDARD tier |
| Not checking bucket exists before delete | Use `getBucketInfo` first |
| Trying to delete non-empty bucket without force | Use `force: true` or empty bucket first |
| Name conflicts | Bucket names must be globally unique |
## Forking and Snapshots
For version control (snapshots/forking), see the **tigris-snapshots-forking** skill.
© tigrisdata · MIT · tigrisdata/skills