namespace-qualified-queue-keys

Qualify namespace-local identifiers into internal queue keys to prevent collisions.

3|3|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/quaid-app/quaid --skill namespace-qualified-queue-keys
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: namespace-qualified-queue-keys
Source: https://github.com/quaid-app/quaid/tree/main/.squad/skills/namespace-qualified-queue-keys
Command: npx skills add https://github.com/quaid-app/quaid --skill namespace-qualified-queue-keys

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Protect namespace-local identifiers when a shared queue schema stores only a single key column, preventing collisions across namespaces.

Core Features & Use Cases

  • Qualifies external namespace-local ids for internal storage, preserving public IDs while avoiding cross-namespace collisions.
  • Builds an internal queue key like <namespace>::<id> at the storage boundary before enqueue/dequeue operations.
  • Maintains the original file/path payload for traceability and avoids leaking internal keys.
  • Tests isolation across namespaces to ensure distinct pending jobs.

Quick Start

Enforce a namespace-qualified internal key when enqueuing and dequeuing items in a single-key queue, ensuring namespace isolation for identical identifiers.

Frequently Asked Questions about namespace-qualified-queue-keys

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

FAQPage Schema
How do I prevent queue key collisions when different namespaces share a single-key queue?

To prevent queue key collisions in shared single-key queues, qualify namespace-local identifiers at the storage boundary by creating an internal key like <namespace>::<id> before enqueue or dequeue operations. This isolates identical identifiers across distinct namespaces.

What is namespace isolation for shared queue schemas?

Namespace isolation for shared queue schemas is the process of qualifying local identifiers so identical IDs from different namespaces remain distinct. It applies when multiple namespaces share a single-key queue column, preventing cross-namespace data collisions during job processing.

Can I preserve the original public identifier while using an internal namespace-qualified queue key?

Yes, you can preserve the original public identifier while using an internal namespace-qualified queue key. The qualification happens at the storage boundary, ensuring the internal key handles isolation while the public id remains unchanged for external traceability.

Does this namespace queue key qualification work with any underlying queue implementation?

Yes, this namespace queue key qualification works with any underlying queue implementation. It remains completely agnostic to the specific storage technology, applying the internal key transformation strictly at the storage boundary before enqueue and dequeue operations.

When do I need to qualify identifiers for a single-key queue?

You need to qualify identifiers for a single-key queue when different namespaces share the same queue schema and use identical local identifiers like session_id or slug. This prevents cross-namespace collisions and ensures distinct pending jobs across the shared storage.

How do I test namespace isolation for identical identifiers in a shared queue?

To test namespace isolation for identical identifiers in a shared queue, enqueue items with the same id from different namespaces. Verify that the internal qualified keys prevent collisions and maintain distinct pending jobs across the namespaces during dequeue operations.