Feature request: Official AI coding skills

[coderwyd]

Hi! First off — Pinia Colada is fantastic. We've adopted it across most of our internal projects at our company, and it's become our go-to data-fetching layer for Vue 3. The API surface is clean, the DX is excellent, and the integration with Pinia feels natural. Great work!

The ask

I'd love to see an official set of AI coding skills for Pinia Colada — specifically for tools like Claude Code, Cursor, and GitHub Copilot.

Why

Many teams (ours included) are now using AI-assisted coding workflows. AI agents frequently reach for @tanstack/vue-query or raw useAsyncData out of habit, because those have more training data and community coverage. When they do use Pinia Colada, they often:

• Default to incorrect patterns (e.g., closing over refs in mutation functions instead of passing args)
• Miss the key stability requirements
• Don't know about useQueryCache for invalidation
• Skip plugin setup (retry, delay-pending)
• Mix up isPending vs isLoading semantics

An official skill file would let teams drop it into their AI tooling config and get correct, idiomatic Colada usage every time — no more correcting the AI mid-conversation.

What I'm envisioning

A skill file (or set of files) covering:

1. useQuery — options, return shape, key stability, placeholderData / initialData patterns
2. useMutation — fire-and-forget vs mutateAsync, renaming conventions, stable closures
3. useQueryCache — invalidation, optimistic updates, cache manipulation
4. Setup & plugins — PiniaColada install order, retry plugin, custom plugins
5. TypeScript patterns — generics, error handling from API clients
6. Common pitfalls — things AI gets wrong without explicit guidance

This would be hugely beneficial to the community, especially as AI-assisted development becomes more mainstream.

Context

We're using Pinia Colada v1.3.x with Vue 3 + TypeScript + Vite. Happy to provide feedback or test an early version if that helps.

Thanks for building such a great library!

[posva]

Thanks, I'm glad you are enjoying it!

Many teams (ours included) are now using AI-assisted coding workflows. AI agents frequently reach for @tanstack/vue-query or raw useAsyncData out of habit

Interesting, this doesn't happen to me: the agent copies what already exists in the project. In my experience, pointing it to docs helps to build initial good practices.

I do have a simple set of skills for pinia colada in https://rulekit.dev/, so I don't know if I will expose a free alternative, I think the docs is enough and everything else is already free.

My advice: either buy rulekit.dev or ask your agent to build a set of skills from the docs, build some stuff and then you can trim the skills more because the agent will just copy from existing good practices