Agent Skills › MapleTechLabs/maple › tinybird-typescript-sdk-guidelines

tinybird-typescript-sdk-guidelines

GitHub

提供 @tinybirdco/sdk 的使用指南，支持在 TypeScript 中定义数据源、管道和查询。涵盖安装配置、类型安全客户端创建、CLI 命令（dev/build/deploy）及连接管理，确保完整的类型推断与类型安全的数据摄入。

.agents/skills/tinybird-typescript-sdk-guidelines/SKILL.md MapleTechLabs/maple

Trigger Scenarios

使用 @tinybirdco/sdk 进行 Tinybird 资源开发需要类型安全的 Tinybird 数据摄入或查询配置或运行 tinybird CLI 命令从旧版文件格式迁移到 TypeScript

Install

npx skills add MapleTechLabs/maple --skill tinybird-typescript-sdk-guidelines -g -y

More Options

Non-standard path

npx skills add https://github.com/MapleTechLabs/maple/tree/main/.agents/skills/tinybird-typescript-sdk-guidelines -g -y

Use without installing

npx skills use MapleTechLabs/maple@tinybird-typescript-sdk-guidelines

指定 Agent (Claude Code)

npx skills add MapleTechLabs/maple --skill tinybird-typescript-sdk-guidelines -a claude-code -g -y

安装 repo 全部 skill

npx skills add MapleTechLabs/maple --all -g -y

预览 repo 内 skill

npx skills add MapleTechLabs/maple --list

SKILL.md

Frontmatter

{
    "name": "tinybird-typescript-sdk-guidelines",
    "description": "Tinybird TypeScript SDK for defining datasources, pipes, and queries with full type inference. Use when working with @tinybirdco\/sdk, TypeScript Tinybird projects, or type-safe data ingestion and queries."
}

Tinybird TypeScript SDK Guidelines

Guidance for using the @tinybirdco/sdk package to define Tinybird resources in TypeScript with complete type inference.

When to Apply

Installing or configuring @tinybirdco/sdk
Defining datasources or pipes in TypeScript
Creating typed Tinybird clients
Using type-safe ingestion or queries
Running tinybird dev/build/deploy commands for TypeScript projects
Migrating from legacy .datasource/.pipe files to TypeScript
Defining connections (Kafka, S3, GCS)
Creating materialized views, copy pipes, or sink pipes

Rule Files

rules/getting-started.md
rules/configuration.md
rules/defining-datasources.md
rules/defining-endpoints.md
rules/typed-client.md
rules/low-level-api.md
rules/cli-commands.md
rules/connections.md
rules/materialized-views.md
rules/copy-sink-pipes.md
rules/tokens.md

Quick Reference

Install: npm install @tinybirdco/sdk
Initialize: npx tinybird init
Dev mode: tinybird dev (uses configured devMode, typically branch)
Build: tinybird build (builds against configured dev target)
Deploy: tinybird deploy (deploys to main/production)
Preview in CI: tinybird preview
Server-side only; never expose tokens in browsers

Version History

01a5dc6 Current 2026-07-05 18:15

Metadata

Files: 0
Version: b079d44
Hash: b576051f
Indexed: 2026-07-05 18:15

tinybird-typescript-sdk-guidelines