#601

Globales Ranking · von 601 Skills

local-first AI Agent Skill

Quellcode ansehen: oakoss/agent-skills

Safe

Installation

npx skills add oakoss/agent-skills --skill local-first

47

Installationen

Local-First

Overview

Local-first is an architecture where the application reads and writes to a local database, with changes syncing to the server in the background. The local database is the source of truth for the UI, providing instant reads, offline support, and optimistic writes by default.

When to use: Collaborative apps needing offline support, latency-sensitive UIs where instant response matters, apps with unreliable network conditions, real-time multiplayer features, mobile apps with intermittent connectivity.

When NOT to use: Simple CRUD apps with reliable connectivity, server-authoritative workflows (payments, inventory), content-heavy sites with minimal interactivity, apps where data freshness from the server is critical on every render.

Quick Reference

Decision Options Key Consideration
Architecture model Server-based, local-first, hybrid Offline needs and latency tolerance drive the choice
Read path Server fetch, local DB read, cache-then-network Local reads are instant; server reads block on network
Write path Server mutation, optimistic update, local-first write Local writes never fail; sync handles delivery
Sync engine Electric, Zero, PowerSync, Replicache, LiveStore Postgres integration vs framework-agnostic
Client storage IndexedDB, OPFS, SQLite WASM, PGlite Capacity limits, query capability, browser support
Conflict resolution LWW, CRDTs, server-wins, field-level merge Complexity vs correctness tradeoff
Data model Normalized tables, document store, CRDT documents Query patterns determine the best model
Partial replication Shapes, subscriptions, query-based sync Sync only what the client needs
Progressive enhancement Server-first with local cache, full local-first Start simple, add local-first incrementally
CQRS separation Separate read/write models, unified model Local-first naturally separates reads from writes
Initial sync Full snapshot, incremental, progressive loading First-load performance vs completeness
Auth integration Token-based shape filtering, row-level security Security lives at the sync layer, not the client
Schema evolution Additive migrations, versioned shapes Local DB schema must evolve without data loss
State management Replace React Query, coexist, hybrid approach Local-first can replace or complement server state
Testing strategy Mock sync engine, test offline scenarios, seed local DB Test both online and offline code paths

Common Mistakes

Mistake Correct Approach
Going local-first for simple CRUD apps Use server-based architecture unless offline/latency is a real need
Choosing a sync engine before defining data model Define read/write patterns first, then pick the engine that fits
Ignoring conflict resolution until late Design conflict strategy alongside data model from the start
Syncing entire database to every client Use partial replication (shapes, subscriptions) for relevant data
Treating local DB as a cache Local DB is the source of truth for the UI, not a cache layer
Using CRDTs for everything LWW or server-wins is simpler and sufficient for most fields
Skipping progressive enhancement Start server-first, add local-first for high-value interactions
Not planning schema migrations Local databases need migration strategies just like server DBs

Delegation

If the electricsql skill is available, delegate ElectricSQL setup, shapes, auth, and write patterns to it.
Otherwise, recommend: pnpm dlx skills add oakoss/agent-skills -s electricsql -a claude-code -y
If the realtime-sync skill is available, delegate WebTransport, pub/sub, and CRDT implementation details to it.
If the tanstack-db skill is available, delegate collection setup, live queries, and optimistic mutation patterns to it.
Otherwise, recommend: pnpm dlx skills add oakoss/agent-skills -s tanstack-db -a claude-code -y
If the tanstack-start skill is available, delegate server function proxies and SSR integration to it.
Otherwise, recommend: pnpm dlx skills add oakoss/agent-skills -s tanstack-start -a claude-code -y

  • Architecture review: Use Plan agent to evaluate local-first vs server-based tradeoffs
  • Sync engine comparison: Use Explore agent to research current engine capabilities
  • Storage benchmarking: Use Task agent to test storage options for specific data patterns

References

Installationen

Installationen 47
Globales Ranking #601 von 601

Sicherheitsprüfung

ath Safe
socket Safe
Warnungen: 0 Bewertung: 90
snyk Low
EU EU-Hosted Inference API

Power your AI Agents with the best open-source models.

Drop-in OpenAI-compatible API. No data leaves Europe.

Explore Inference API

GLM

GLM 5

$1.00 / $3.20

per M tokens

Kimi

Kimi K2.5

$0.60 / $2.80

per M tokens

MiniMax

MiniMax M2.5

$0.30 / $1.20

per M tokens

Qwen

Qwen3.5 122B

$0.40 / $3.00

per M tokens

So verwenden Sie diesen Skill

1

Install local-first by running npx skills add oakoss/agent-skills --skill local-first in your project directory. Führen Sie den obigen Installationsbefehl in Ihrem Projektverzeichnis aus. Die Skill-Datei wird von GitHub heruntergeladen und in Ihrem Projekt platziert.

2

Keine Konfiguration erforderlich. Ihr KI-Agent (Claude Code, Cursor, Windsurf usw.) erkennt installierte Skills automatisch und nutzt sie als Kontext bei der Code-Generierung.

3

Der Skill verbessert das Verständnis Ihres Agenten für local-first, und hilft ihm, etablierte Muster zu befolgen, häufige Fehler zu vermeiden und produktionsreifen Code zu erzeugen.

Was Sie erhalten

Skills sind Klartext-Anweisungsdateien — kein ausführbarer Code. Sie kodieren Expertenwissen über Frameworks, Sprachen oder Tools, das Ihr KI-Agent liest, um seine Ausgabe zu verbessern. Das bedeutet null Laufzeit-Overhead, keine Abhängigkeitskonflikte und volle Transparenz: Sie können jede Anweisung vor der Installation lesen und prüfen.

Kompatibilität

Dieser Skill funktioniert mit jedem KI-Coding-Agenten, der das skills.sh-Format unterstützt, einschließlich Claude Code (Anthropic), Cursor, Windsurf, Cline, Aider und anderen Tools, die projektbezogene Kontextdateien lesen. Skills sind auf Transportebene framework-agnostisch — der Inhalt bestimmt, für welche Sprache oder welches Framework er gilt.

Data sourced from the skills.sh registry and GitHub. Install counts and security audits are updated regularly.

EU Made in Europe

Chat with 100+ AI Models in one App.

Use Claude, ChatGPT, Gemini alongside with EU-Hosted Models like Deepseek, GLM-5, Kimi K2.5 and many more.

Start for free View pricing
Kundensupport