Introducing PowerSync Agent Skills

We've published PowerSync Agent Skills, a public repository of skills that help AI coding agents build apps with PowerSync.

Available skills

The initial release includes one PowerSync skill, built from a main skill file plus a set of reference documents so agents load only what’s needed for the task. It follows the Agent Skills specification: once installed, agents use the main skill to decide what to load for the task (e.g. new project → SDK refs; debugging sync → powersync-debug.md), pull only those references, and apply the relevant parts automatically.

The main skill (skills/powersync/SKILL.md) provides agents with an architecture overview, a quick reference table of what to load per task, and key rules that  should be applied without being asked. Separate focused docs (skills/powersync/references/) include:

• Topic references: for high-level context, debugging sync/connection issues, writing or migrating sync config, service/CLI setup.

• SDK references for core JavaScript/TypeScript plus framework-specific files (React/Next.js, React Native/Expo, Vue/Nuxt, Node.js, TanStack Query & DB), and references for Dart (Flutter), .NET, Kotlin, Swift (including GRDB), and handling files/attachments.

Why we built this

We want to improve support for AI-assisted development with PowerSync. User feedback showed that even with full documentation available, agents often struggled with initial project setup, SDK-specific patterns (which APIs to use, how to wire uploads, and so on), and assisting with debugging.

Agent skills address that by providing coding agents task- and SDK-specific references with current APIs and actionable patterns, and by encoding best practices and common gotchas so agents apply them without having to spell every rule out in conversation.

This repo is one step in making PowerSync work well with AI-assisted development, and we'll keep evolving it.

Existing AI-oriented resources

Agent skills sit alongside other resources we already provide for AI consumption:

• llms.txt - A long-form reference document (100+ pages) that many AI tools can ingest.

• Documentation as Markdown - Our docs are exportable as Markdown for use in RAG pipelines or agent context.

For details and links, see our AI tools docs.

Where this fits

Agent skills are part of making PowerSync fully automatable by AI agents. Together with the overhauled PowerSync CLI, which offers config-as-code and programmatic access to PowerSync instances, agents can set up and deploy PowerSync projects without manual dashboard steps.

We believe that a good CLI + Skills are the way to go when optimizing agent experience. On the docs side, we've been working on making everything easier to follow for both humans and agents, and we're continuing to iterate on this.

Getting started

• Skills repo: github.com/powersync-ja/agent-skills

• Installation: Follow the README to add skills to your AI coding environment (e.g. Skills.sh, Claude Code).

• Documentation: docs.powersync.com/tools/ai-tools

• CLI docs: docs.powersync.com/tools/cli

We want your feedback

We invite you to contribute by submitting PRs to the agent-skills repo, opening issues or suggestions there, or sharing your experience in Discord. Based on how you use PowerSync and where your agents struggle, we'll prioritize what to improve next.