Skill Feedback: meta-framework (good)

Skill Feedback: meta-framework

Package: @tanstack/db
Skill version: 0.5.30
Rating: good

Task

Integrate TanStack DB collections (via Durable Streams StreamDB) into a TanStack Start route with reactive queries.

What Worked

• The meta-framework skill clearly documents the ssr: false requirement
• useLiveQuery with the query builder API worked correctly once the Collection deduplication issue was resolved
• The collection.preload() pattern in route loaders worked well
• react-db skill's examples for useLiveQuery with dependency arrays were accurate

What Failed

Nothing in the TanStack DB skills themselves failed. The issues were in the upstream @durable-streams/state package resolution.

Missing

• Cross-library Collection deduplication guidance — When third-party packages (like @durable-streams/state) create Collections using their own resolved @tanstack/db, the instanceof check in useLiveQuery fails. The meta-framework or collection-setup skill could mention this pitfall and the Vite resolve.alias workaround for packages that don't properly declare @tanstack/db as a peerDependency.

Self-Corrections

1. Added ssr: false after SSR error — should have loaded meta-framework skill before writing the route

User Comments

• The agent should have loaded the meta-framework skill proactively before writing route code, since the intent-skills mapping in CLAUDE.md pointed to it

Review the meta-framework and collection-setup skill guidance, along with the intent-skills mapping in CLAUDE.md. Reproduce the cross-library Collection setup with @durable-streams/state and Vite's resolve.alias, then document the instanceof failure, the @tanstack/db peerDependency requirement, and the workaround so the guidance covers the ssr: false and useLiveQuery patterns.