powersync SKILL.md skillA

powersync from powersync-ja/agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

mdr add powersync-ja/agent-skills/powersync@"1.6.5" # x-release-please-version

Pins "1.6.5" # x-release-please-version in mdr.lock. Pin the fingerprint instead.

Audit grade

A, 17 of 17 checks passed

Kind

SKILL.md skill

Repository

powersync-ja/agent-skills

Path

skills/powersync/SKILL.md

Versions recorded

13

Latest version

"1.6.5" # x-release-please-version, committed Nov 4, 2026

First version recorded

Sep 8, 2026

Size

9,440 bytes

Repository stars

21

License

MIT

Best practices for building and maintaining applications with PowerSync: Cloud and self-hosted setup, sync configuration, client SDK usage, backend integration (Supabase, custom Postgres, MongoDB, Azure DocumentDB, MySQL, MSSQL), schema changes, watch and reactive queries (useQuery), attachments, the upload queue, and debugging. Use this skill whenever the user mentions PowerSync, a @powersync/* package (@powersync/web, @powersync/react-native, @powersync/node), the powersync Flutter/Dart…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# PowerSync Skills

Use this skill to onboard a project onto PowerSync and to keep it healthy afterwards, without trial-and-error. Treat this as a guided workflow first and a reference library second.

**Agents: Read [AGENTS.md](AGENTS.md) before proceeding.** It contains the mandatory compliance rules and onboarding playbook. The Quick Rules below are a reminder, not a substitute. **`powersync login`** is **PowerSync Cloud only** (PAT); self-hosted does not use it.

## Terminology

- **Operator** — the human directing this agent (whose request you are fulfilling).
- **User** — an end-user of the operator's PowerSync app (JWT subjects, the row a sync stream filters by, the person calling `disconnectAndClear()`).

If a sentence is ambiguous, default to the operator interpretation. Full legend in `AGENTS.md`.

## Quick Rules

- **CLI-first.** Use the [PowerSync CLI](https://docs.powersync.com/tools/cli.md) for all operations. Do not hand-write config files. See `references/powersync-cli.md`.
- **Ask, don't assume.** Ask the operator: Cloud vs self-hosted, and which backend (Supabase, Postgres, MongoDB, Azure DocumentDB, MySQL, MSSQL). Do not default to Supabase.
…

Read the whole file at its exact version.

How to install

mdr add powersync-ja/agent-skills/powersync@sha256:1b992bf0d9bac583

[![mdr](https://markdownregistry.com/badge/art_2fcrlm5gxutib3rx.svg)](https://markdownregistry.com/a/art_2fcrlm5gxutib3rx)

Versions

The registry has recorded 13 versions of this file, between Sep 8, 2026 and Nov 4, 2026, about one every 5 days.

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_2fcrlm5gxutib3rx
GET https://markdownregistry.com/api/v1/resolve?ref=powersync-ja/agent-skills/powersync
GET https://markdownregistry.com/api/v1/blob/1b992bf0d9bac583ccbd6780c52c17daa8d7310ee3045b9f4c34a6f0e9782fd0

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from powersync-ja/agent-skills

Every file in powersync-ja/agent-skills

Browse by kind, by grade A, or by owner.