mcpField
A
android-serialization-offline-sync

android-serialization-offline-sync

github.com/krutikjainDevelopment1461 installsUpdated 31w ago
Repository

About android-serialization-offline-sync

A skill for Android developers coordinating serialization, caching, conflict handling, and offline-first synchronization. It emphasizes typed models, durable user data, and validating retries and process-death behavior.

Key features

  1. 01Coordinate serialization and offline sync
  2. 02Define data contracts and model mapping
  3. 03Handle caching and data conflicts
  4. 04Validate retries and process-death behavior

Use cases

  1. 01Design offline-first data flows
  2. 02Sync local edits with remote data
  3. 03Resolve timestamp conflicts after offline edits

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/krutikjain/android-agent-skills --skill android-serialization-offline-sync

After installing, type/android-serialization-offline-syncin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
references/
official-links.md
patterns.md
scenarios.md
scripts/
run_examples.sh

Details

From the project README

Android Serialization Offline Sync

When To Use

  • Use this skill when the request is about: offline sync android, serialization model mapping android, conflict resolution android cache.
  • Primary outcome: Coordinate serialization, caching, conflict handling, and offline-first sync flows in Android apps.
  • Handoff skills when the scope expands:
  • android-networking-retrofit-okhttp
  • android-room-database

Workflow

  1. Confirm the data source, persistence boundary, sync model, and device capability involved.
  2. Model contracts explicitly before wiring network, storage, media, or background APIs.
  3. Apply the recommended AndroidX or platform pattern with migration-safe defaults.
  4. Validate offline, retry, and process death behavior against the sample apps and scenarios.
  5. Escalate security, performance, or release risk to the linked supporting skills when needed.

Guardrails

  • Prefer typed models and explicit serializers over ad-hoc maps or bundles.
  • Keep background work idempotent and cancellation-aware.
  • Do not leak storage, media, or networking details into presentation code.
  • Treat user data durability, privacy, and migration paths as part of the implementation.

Anti-Patterns

  • Blocking the main thread with disk or network calls.
  • Treating retryable sync failures as terminal user-facing errors.
  • Mixing cache models and wire models without a mapping layer.
  • Requesting broad storage or notification capabilities when a narrower API exists.

Examples

Happy path
  • Scenario: Sync local task edits to a remote model with explicit mapping.
  • Command: cd examples/orbittasks-compose && ./gradlew :app:testDebugUnitTest
Edge case
  • Scenario: Recover when remote and local timestamps disagree after offline edits.
  • Command: cd examples/orbittasks-xml && ./gradlew :app:testDebugUnitTest
Failure recovery
  • Scenario: Keep sync/serialization work separate from pure networking or Room-only requests.
  • Command: python3 scripts/eval_triggers.py --skill android-serialization-offline-sync

Done Checklist

  • The implementation path is explicit, minimal, and tied to the right Android surface.
  • Relevant example commands and benchmark prompts have been exercised or updated.
  • Handoffs to adjacent skills are documented when the request crosses boundaries.
  • Official references cover the chosen pattern and the main migration or troubleshooting path.

Official References

Comments

Markdown supported