Name: eventlog-local-first
Author: xesrevinu

Imported from xesrevinu/skills (eventlog-local-first/SKILL.md). Install upstream with npx skills add xesrevinu/skills --skill eventlog-local-first. Copyright stays with the author.

EventLog / Local-First Skill

Patterns for EventLog local-first sync with progressive disclosure.

Core Rules

Write locally first, then replicate; never bypass the local journal.
Define each event with a stable tag and conflict primaryKey.
Keep payloads schema-validated and encoded for durable storage.
Let server assign remote sequence numbers; clients do not own ordering.
Keep E2E encryption boundaries strict: server never sees plaintext.
Run sync in daemon/background fibers, not on UI request paths.

Read This Skill Efficiently

Load only what the task needs:

Architecture, event schema, journal, sync protocol -> references/engine-patterns.md
Encryption, vault, daemon, and platform adapters -> references/engine-patterns.md
Failure modes, anti-patterns, and readiness checklist -> references/engine-patterns.md

Default Delivery Order

Define events and EventGroup contracts (payload, success, error, primary key).
Implement journal persistence and remote-sequence aware sync writes.
Implement sync transport handlers and conflict resolution strategy.
Wire encryption and key management layers.
Start daemon lifecycle at app bootstrap and track status in state.

Related Skills

cloudflare-workers for DO runtime, queue, cron, and worker composition
effect-best-practices for domain/service/transport layering
otel-fullstack for telemetry across client/worker/server sync paths

Install eventlog-local-first and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "xesrevinu-skills-eventlog-local-first", "kind": "skill", "name": "eventlog-local-first", "description": "Implement and maintain the EventLog local-first sync engine with event groups, offline journal persistence, E2E-encrypted replication, daemon lifecycle, and conflict resolution. Use when building or debugging local-first sync behavior.", "publisher": "xesrevinu", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Implement and maintain the EventLog local-first sync engine with event groups, offline journal persistence, E2E-encrypted replication, daemon lifecycle, and conflict resolution. Use when building or debugging local-first sync behavior." ], "primary": false, "metadata": { "source": { "provider": "github", "repository": "https://github.com/xesrevinu/skills", "path": "eventlog-local-first/SKILL.md", "ref": "926179434f23ff7ee1ebeb9f687d30a24ff07acb", "url": "https://github.com/xesrevinu/skills/blob/926179434f23ff7ee1ebeb9f687d30a24ff07acb/eventlog-local-first/SKILL.md", "key": "xesrevinu/skills/eventlog-local-first/SKILL.md" } }, "instructions": "# EventLog / Local-First Skill\n\nPatterns for EventLog local-first sync with progressive disclosure.\n\n## Core Rules\n\n1. Write locally first, then replicate; never bypass the local journal.\n2. Define each event with a stable `tag` and conflict `primaryKey`.\n3. Keep payloads schema-validated and encoded for durable storage.\n4. Let server assign remote sequence numbers; clients do not own ordering.\n5. Keep E2E encryption boundaries strict: server never sees plaintext.\n6. Run sync in daemon/background fibers, not on UI request paths.\n\n## Read This Skill Efficiently\n\nLoad only what the task needs:\n\n", "cost": { "context_tokens": 366 } }

eventlog-local-first

About