Commit Graph

61 Commits

Author SHA1 Message Date
Paco Gonzalez f8b4f4f8f5 skills: tighten JSON extraction section to when/how-to-apply 2026-07-28 12:15:41 +02:00
Paco Gonzalez 909bff109d skills: clarify missing-field default-value note 2026-07-28 12:01:48 +02:00
Paco Gonzalez 2d4d69c952 skills: simplify JSON tuple example to native types
Use native types (Int64) directly in the tuple schema instead of the
String + toXOrZero fallback trick, and note that missing fields simply
resolve to the type's default value.
2026-07-28 12:00:24 +02:00
Paco Gonzalez f52bf0686f skills: document single-parse JSON extraction pattern for materialized views
Repeated per-field visitParamExtract*/JSONExtract* calls re-parse the same
JSON payload from scratch for every field, which is especially costly in
materialized views since it runs on every inserted block. Document parsing
once via JSONExtract(...'Tuple(...)') + getSubcolumn instead, with guidance
on preserving optional-field fallback behavior via String-typed tuple
fields and toXOrZero/toXOrDefault.

AI-assisted with Claude Code; lightly tested against a real production
pipe rewrite.
2026-07-27 16:50:26 +02:00
Paco González López 960fb75167 Merge pull request #19 from tinybirdco/feature/add-skill-mv-join-optimization
Add rule: pre-filter right-side JOINs in materialized views
2026-06-17 15:32:06 +02:00
Paco Gonzalez 41dd28f20b skills: add new optimization skill for mv with joins 2026-06-17 12:56:12 +02:00
Pablo Abella d60d8385be Merge pull request #17 from tinybirdco/feature/improve-cli-and-best-practices-skills
Improve CLI and best practices skills with workflow, CI/CD, and architecture guidance
2026-05-12 15:21:55 +02:00
Pablo Abella 7b71e5b40f Use underscored branch names consistently
Branch names must use underscores, not hyphens. Restore the naming
convention note and fix all branch name examples across CI/CD and
branch development docs.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-05-12 10:33:38 +02:00
Pablo Abella d8e784968b Align skills with official Tinybird docs
- Use `tb --local build` and `tb --local test run` in CI examples
- Use `tb --cloud deploy` and `tb --cloud deploy --check` consistently
- Add `tb dev` as the main development command across workflows
- Add `--with-connections` flag and connector management for branches
- Fix preview branch naming to `tmp-ci-<branch>` per docs
- Add two-step deployment: `tb --cloud deployment create --wait` / `promote`
- Add `datasource sample` and `datasource start` for connector testing

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-05-12 10:33:13 +02:00
Pablo Abella 979c4227c9 Update CI/CD guide: add local build/test steps and preview environments
Add tb build and tb test run steps before deploy --check in CI examples
to match the official Tinybird CI workflow with Tinybird Local service
containers. Add preview environments section covering both SDK-based
(tinybird preview) and manual (tb branch create) approaches, cleanup,
and connector support.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-05-12 10:09:17 +02:00
Pablo Abella 258c94edbe Improve CLI and best practices skills with workflow, CI/CD, and architecture guidance
Add development workflow documentation covering local, branch, and cloud
workflows so users can choose the right approach for their project. Document
the branch development workflow including --last-partition, branch tokens,
and client app integration patterns. Add CI/CD integration patterns with
GitHub Actions and GitLab CI examples.

Expand best practices with data layer architecture guidance, multi-directory
project organization, Tinybird terminology conventions, richer FORWARD_QUERY
migration examples, endpoint testing tips, and fixture data workflows.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-05-11 16:27:53 +02:00
gnzjgo a33c7fbc1a Merge pull request #15 from tinybirdco/docs/add-python-sdk-to-readme
docs: add Python SDK skills to README
2026-03-23 16:24:42 +01:00
Julia Vallina caba40a81f docs: add Python SDK skills to README
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-23 15:46:49 +01:00
gnzjgo 31dbbb3bc5 Merge pull request #14 from tinybirdco/update-skills-new-flow
Update Tinybird skills for new build/deploy flow
2026-03-16 16:32:20 +01:00
gnzjgo 4ab6685571 Update Tinybird skills for new build/deploy flow
Amp-Thread-ID: https://ampcode.com/threads/T-019cf719-5a5f-742a-a7f9-c079b521e438
Co-authored-by: Amp <amp@ampcode.com>
2026-03-16 16:28:56 +01:00
Rafa Moreno f62dc2ffff Merge pull request #13 from tinybirdco/rmorehig/python-sdk-skills
Add Python SDK skill and extend TypeScript SDK
2026-03-10 14:57:58 +01:00
Rafa Moreno 21ab1ab24e feat: add Python SDK skill and extend TypeScript SDK skill
Add new tinybird-python-sdk-guidelines skill with 12 rule files covering
the tinybird-sdk Python package features including datasources, endpoints,
connections, materialized views, copy/sink pipes, and JWT tokens.

Extend tinybird-typescript-sdk-guidelines with 4 new rule files (connections,
materialized-views, copy-sink-pipes, tokens) and add migrate/pull CLI commands.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-03-10 14:39:51 +01:00
gnzjgo 86d28b9207 Merge pull request #12 from tinybirdco/fix/tinybird-skill-malicious-url-flag
fix(tinybird): replace placeholder URL flagged as malicious
2026-02-26 16:00:48 +01:00
gnzjgo e43d9679ce fix(tinybird): replace placeholder URL with safe example domain
Amp-Thread-ID: https://ampcode.com/threads/T-019c9a5f-2e27-761b-b7f4-defb25e73d1e
Co-authored-by: Amp <amp@ampcode.com>
2026-02-26 15:52:02 +01:00
gnzjgo aff3b00679 Merge pull request #11 from tinybirdco/default-copy-mode-is-append
default copy_mode is append
2026-02-24 20:37:08 +01:00
Enric Calabuig 0612fd9ee4 default copy_mode is append 2026-02-24 18:45:14 +01:00
gnzjgo 9c58674c98 Merge pull request #10 from tinybirdco/docs/skill-groups
update readme
2026-02-12 16:53:38 +01:00
gnzjgo 47ab4eefb1 update readme 2026-02-12 16:49:10 +01:00
gnzjgo b159c40f1c Merge pull request #9 from tinybirdco/rmorehig/split-tinybird-skills
Split Tinybird skills into 3 focused skills
2026-02-12 12:26:28 +01:00
Rafa Moreno 305009e157 Rename SDK rule files to be more descriptive
- sdk-overview.md → getting-started.md
- sdk-configuration.md → configuration.md
- sdk-datasources.md → defining-datasources.md
- sdk-endpoints.md → defining-endpoints.md
- sdk-client.md → typed-client.md
- sdk-api.md → low-level-api.md
- sdk-cli.md → cli-commands.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-11 16:22:01 +01:00
Rafa Moreno fb8d1d346b Rename skills to add -guidelines suffix
- tinybird-cli → tinybird-cli-guidelines
- tinybird-typescript-sdk → tinybird-typescript-sdk-guidelines

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-11 16:07:10 +01:00
Rafa Moreno 9aa65c02f8 Split Tinybird skills into 3 focused skills
- tinybird-best-practices: file formats, SQL, optimization, patterns
- tinybird-cli: CLI commands, workflows, data operations
- tinybird-typescript-sdk: TypeScript SDK with type inference

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-11 16:05:45 +01:00
gnzjgo 344761ddb9 Merge pull request #8 from tinybirdco/add_advanced_endpoint_optimization_recommendations
Add advanced endpoint optimizations
2026-02-09 12:12:21 +01:00
gnzjgo 4da8e211b5 Merge branch 'main' into add_advanced_endpoint_optimization_recommendations 2026-02-09 12:09:37 +01:00
gnzjgo f7e8c0cb64 Merge deep endpoint optimization rules into endpoint-optimization.md
Consolidates endpoint-optimization-deep.md into the existing file:
- Adds "Gathering Runtime Data" section with actionable queries
- Adds structural rules (unnecessary columns, Nullable, casting, etc.)
- Adds runtime-dependent rules with thresholds (PREWHERE, skip indexes,
  FINAL, JSON extraction, TTL, partitioning, approximate uniques, etc.)
- Removes persona prompt, aligns style with other rule files
- Removes redundant rules already covered by the original file

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 00:33:12 +01:00
gnzjgo 123b88003d added rule to skill 2026-01-22 18:19:11 +01:00
Jordi Contestí 8c8b372de1 Add advanced endpoint optimizations 2026-01-22 15:03:20 +01:00
gnzjgo 52435474e1 Merge pull request #7 from tinybirdco/explain
optimiz 101
2026-01-22 11:35:01 +01:00
gnzjgo 3e433e57d8 optimiz 101 2026-01-22 01:07:07 +01:00
gnzjgo e3fe88fa84 Merge pull request #6 from tinybirdco/fix-skill-md-file-list
Fix SKILL.md
2026-01-21 10:34:34 +01:00
Alison Davey 0b7ab1025b Fix SKILL.md 2026-01-21 10:26:34 +01:00
Rafa Moreno 52b4eca467 Merge pull request #4 from tinybirdco/install
install-draft
2026-01-20 23:38:31 +01:00
gnzjgo 5ae52ad418 npx ftw 2026-01-20 23:36:12 +01:00
Rafa Moreno 9b3e927ff6 Merge pull request #3 from tinybirdco/fix-skill-docs
minor fixes to rules
2026-01-20 20:39:59 +01:00
Rafa Moreno 10cd993f2e Merge pull request #2 from tinybirdco/first-pass
first pass
2026-01-20 20:39:27 +01:00
Rafa Moreno dba2d745d9 Merge pull request #5 from tinybirdco/add-contributing
Add CONTRIBUTING.md
2026-01-20 20:38:59 +01:00
Rafa Moreno d64cfb7718 Fix Twitter handle to @tinybird 2026-01-20 20:36:06 +01:00
Rafa Moreno 94a1744ee2 Add CONTRIBUTING.md 2026-01-20 20:32:03 +01:00
gnzjgo 15460ce439 install-draft 2026-01-20 19:08:20 +01:00
Alison Davey 3b4809dcf2 minor fixes to rules 2026-01-20 17:48:18 +01:00
gnzjgo 172602c059 first pass 2026-01-20 17:22:58 +01:00
Rafa Moreno 4726eafbbf next steps 2026-01-16 00:07:16 +01:00
Rafa Moreno 8ab9894143 add more quick reference notes 2026-01-15 23:59:38 +01:00
Rafa Moreno 3af89c502d remove wrong rules 2026-01-15 23:58:20 +01:00
Rafa Moreno 550928c944 remove not existing references 2026-01-15 23:57:54 +01:00