tinybird-cli-guidelines

Descripción general de la habilidad tinybird-cli-guidelines

La habilidad tinybird-cli-guidelines es una guía práctica para usar Tinybird CLI (tb) con menos errores por suposiciones y mejores decisiones de flujo de trabajo. Es ideal para backend developers, data engineers y agentes que necesitan crear, validar, desplegar u operar proyectos de Tinybird sin inventar flags ni ejecutar por accidente el destino equivocado.

Lo que normalmente importa a los usuarios es algo muy concreto: “¿Qué comando tb debo ejecutar, en qué entorno y qué debo revisar antes de cambiar datos o hacer deploy?” Esta habilidad se centra justamente en ese trabajo. La guía tinybird-cli-guidelines destaca especialmente cuando necesitas que el desarrollo local, el despliegue en Cloud, las operaciones de datos, los datos mock o el manejo de tokens/secrets se mantengan coherentes.

Por qué merece la pena instalar esta habilidad tinybird-cli-guidelines

Su valor principal es el control del flujo de trabajo, no solo el descubrimiento de comandos. tinybird-cli-guidelines install es útil si quieres una habilidad que ponga el foco en el comportamiento de CLI 4.0, el targeting de entornos y los hábitos operativos seguros. Ayuda a reducir errores con tb build, tb deploy, cambios destructivos de datos y la confusión entre local y Cloud.

Mejor encaje para backend development

Usa tinybird-cli-guidelines for Backend Development cuando tu trabajo toque datasources, pipes, despliegues o pruebas locales de Tinybird. Encaja bien si necesitas una guía operativa compacta para la CLI tb, sobre todo en repositorios donde el comportamiento de build/deploy depende de tinybird.config.json.

Lo que no pretende hacer

No es un tutorial genérico de Tinybird ni un resumen completo del repositorio. Es una habilidad de apoyo a la toma de decisiones para el uso de la CLI y el flujo operativo. Si solo necesitas la explicación puntual de un comando, puede bastar con tb <command> --help; si necesitas un flujo de trabajo repetible, la habilidad aporta más valor.

Cómo usar la habilidad tinybird-cli-guidelines

Instálala y verifica el alcance de la habilidad

Instala tinybird-cli-guidelines con:

npx skills add tinybirdco/tinybird-agent-skills --skill tinybird-cli-guidelines

Después de instalarla, lee primero SKILL.md y luego abre los archivos de reglas de apoyo que coincidan con tu tarea. Los archivos más útiles son rules/cli-commands.md, rules/build-deploy.md, rules/local-development.md y rules/data-operations.md.

Convierte una petición imprecisa en un prompt útil

La habilidad funciona mejor cuando tu prompt incluye:

• el objetivo: build, deploy, append, replace, delete o test
• el entorno: local, branch o cloud
• el elemento: datasource, pipe, token, secret o archivo de proyecto
• el nivel de riesgo: comprobación segura, no destructivo o cambio destructivo confirmado

Un prompt más sólido se parece a: “Usa tinybird-cli-guidelines para validar un proyecto de Tinybird, explicar qué comandos tb ejecutar en CLI 4.0 y evitar deploys destructivos salvo que lo confirme.”

Lee primero los archivos adecuados

Empieza con SKILL.md y luego usa el archivo de reglas que corresponda a la tarea:

• rules/build-deploy.md para tb build y tb deploy
• rules/data-operations.md para comportamientos de delete/replace/truncate
• rules/append-data.md para añadir archivos, URLs o eventos
• rules/local-development.md para configuración y solución de problemas de Tinybird Local
• rules/tokens.md y rules/secrets.md para trabajo de autenticación y configuración

Usa las reglas de flujo de trabajo, no la memoria

La guía de mayor valor en tinybird-cli-guidelines usage es respetar el contexto de CLI 4.0. Configura dev_mode en tinybird.config.json y luego usa tb build y tb deploy sin flags extra, salvo que realmente necesites overrides manuales. Antes de cualquier comando que pueda cambiar producción o borrar datos, comprueba la sintaxis exacta en la habilidad o confírmala con tb <command> --help.

Preguntas frecuentes de la habilidad tinybird-cli-guidelines

¿tinybird-cli-guidelines es solo para expertos en Tinybird?

No. Es útil para principiantes que necesitan valores predeterminados más seguros y para usuarios con experiencia que quieren menos errores de entorno. La habilidad resulta especialmente útil cuando sabes cuál es tu objetivo de negocio, pero no cuál es la ruta más segura en la CLI de Tinybird.

¿En qué se diferencia de un prompt normal?

Un prompt normal puede describir la tarea, pero tinybird-cli-guidelines te da un modelo operativo reutilizable: dónde mirar, qué confirmar y cuándo parar para pedir aprobación. Eso importa sobre todo en tb build, tb deploy y los comandos de mutación de datos.

¿Cuándo no debería usar esta habilidad?

Sáltatela si no estás trabajando con comandos de Tinybird CLI, Tinybird Local o flujos de despliegue de Tinybird. Tampoco hace falta para preguntas muy simples de solo lectura que no impliquen archivos del proyecto, entornos o riesgo operativo.

¿Cubre tanto flujos locales como en Cloud?

Sí. La guía tinybird-cli-guidelines cubre Tinybird Local, desarrollo basado en branches y despliegue en Cloud. Eso la hace una buena opción cuando necesitas pasar de la iteración local a producción con menos decisiones manuales.

Cómo mejorar la habilidad tinybird-cli-guidelines

Dale a la habilidad la operación y el destino exactos

Cuanto mejor sea tu input, mejor será la salida. En lugar de “ayúdame con Tinybird”, di “haz una comprobación segura de build local”, “prepara una revisión de deploy a producción” o “añade datos CSV a un datasource existente”. Incluye el nombre del datasource o del proyecto, y señala si el destino es local, branch o cloud.

Indica tus restricciones desde el principio

El mayor modo de fallo es un riesgo poco claro. Si no puedes permitir cambios destructivos, dilo antes de que la habilidad sugiera tb deploy --allow-destructive-operations o un comando de reemplazo. Si trabajas en main o master, menciónalo también, porque el comportamiento en modo branch es distinto.

Aporta entradas concretas para trabajo con datos

Para tinybird-cli-guidelines usage en tareas de append, replace o delete, comparte la ruta del archivo, la condición sobre filas, la clave de partición y si el esquema no cambia. Por ejemplo: “Sustituye las filas de noviembre en events usando data.csv; la clave de partición es country; no toques la ingesta activa”. Ese nivel de detalle evita planes de comando inseguros o incompletos.

Itera con comprobaciones antes de pasar a producción

Usa tb info, tb deploy --check y el archivo de reglas correspondiente antes de promover nada a Cloud main. Si el primer resultado es demasiado genérico, refina la solicitud añadiendo el comando, el entorno y los archivos exactos que quieres que la habilidad inspeccione.