Unified Queue Design

Queue offline client actions in IndexedDB for retry against the server.

2|1|Updated Dec 3, 2025
One-click install
npx skills add https://github.com/sklonely/ClassNoteAI --skill unified-queue-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Unified Queue Design
Source: https://github.com/sklonely/ClassNoteAI/tree/main/.agent/skills/unified_queue_design
Command: npx skills add https://github.com/sklonely/ClassNoteAI --skill unified-queue-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Establishes a robust pattern for client-to-cloud interactions using the OfflineQueueService to ensure offline support, synchronization, and prevents data loss.

Core Features & Use Cases

  • Offline resiliency: capture user intents while offline and replay when online.
  • Server-first workflow: push intents to the server, deferring direct execution until connected.
  • Reliable retries: automatically retry failed requests with an outbox queue to maintain data integrity.

Quick Start

Configure your client to initialize the OfflineQueueService, enqueue eligible actions while offline, and allow automatic processing once connectivity is restored.

Frequently Asked Questions about Unified Queue Design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I queue offline client actions and retry them when connectivity is restored?

You can queue offline client actions by using an IndexedDB-backed OfflineQueueService that captures user intents and automatically retries them against the server when connectivity is restored.

What is a server-first offline queue and when do I need it?

A server-first offline queue defers direct client execution and pushes actions to the server upon reconnection. You need it to prevent data loss and maintain synchronization during intermittent connectivity.

How do I implement reliable retries for failed requests in an offline-first app?

You can implement reliable retries by configuring an outbox queue that captures offline actions, registers processors, and automatically replays failed requests to maintain data integrity once online.

Can I use an offline queue for chat and data synchronization in a server-first architecture?

Yes, the offline queue supports chat, data synchronization, and trigger-based tasks in server-first architectures by capturing intents while offline and coordinating online transitions through direct execution or enqueue patterns.

What's the best way to prevent data loss when offline synchronization fails?

To prevent data loss when offline synchronization fails, use an outbox queue pattern that preserves user intents in IndexedDB and automatically retries failed requests until the server confirms successful processing.

Does this offline queue approach work without external dependencies?

Yes, the offline queue pattern operates without external dependencies by relying on an internal IndexedDB-backed OfflineQueueService to manage queue storage, processor registration, and online-offline state transitions.