Add TanStack Intent maintainer skills for the Supabase collection adapter

Open
#8 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
64/100
Issue type
Feature
Clarity
Clearly specified
Activity status
Quiet
Tech stack
github-actions, typescript
Domain
ci-cd, documentation, tooling

Research direction

Start with the TanStack Intent maintainer quick start and run the scaffold flow for @supabase-labs/tanstack-db. Review the generated skills/ and _artifacts/ files, then update package.json, add the validation/staleness workflow, and document the refresh process. Run npx @tanstack/intent@latest validate; done means the package-specific skills are present, publishable, documented, and valid.

Written by the indexing model from the issue text.

Description

enhancement ready-for-agent

What to build

Adopt TanStack Intent's maintainer workflow for @supabase-labs/tanstack-db, following the TanStack Intent maintainer quick start:

https://tanstack.com/intent/latest/docs/getting-started/quick-start-maintainers

This issue is about creating and shipping agent-consumable skills for this library, not adding a runtime Intent API to the Supabase collection adapter. The goal is to make it easier for AI agents and coding assistants to use this package correctly by giving them versioned, package-local guidance about the adapter's APIs, patterns, limitations, and common failure modes.

The implementation should run the TanStack Intent scaffolding flow, use the generated prompt to discover the package's domain and usage patterns, and commit the resulting skills/ tree plus the _artifacts/ files that explain how the skills were produced. The first skill set should cover the package's core tasks: creating Supabase-backed TanStack DB collections, configuring keys and schemas, using Realtime safely, understanding query pushdown and client-side fallback behavior, and avoiding common mistakes with large result sets, RLS, and mutation semantics.

The package should also be configured for publishing Intent skills. That includes updating package.json as required by npx @tanstack/intent@latest edit-package-json, adding the validation/staleness workflow from npx @tanstack/intent@latest setup, and documenting how maintainers should validate and refresh skills as the package evolves.

Acceptance criteria

  • Run or follow the TanStack Intent maintainer scaffold flow for this package.
  • Add an initial skills/ tree for @supabase-labs/tanstack-db with package-specific guidance.
  • Commit the generated _artifacts/ files needed to audit and refresh the skill set.
  • Configure package.json so the skills ship with the npm package.
  • Add the TanStack Intent skill validation/staleness workflow.
  • Verify the skills with npx @tanstack/intent@latest validate.
  • Document the maintainer workflow for updating stale skills after package changes or releases.

Blocked by

None - can start immediately.

Dominant language
TypeScript
Stars
57
Forks
5
Avg merge
5d 22h
Merged PRs (30d)
7

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from supabase/tanstack-db

All issues in supabase/tanstack-db

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.