skills.rest
cyberpunk042
cyberpunk042COMMUNITY
Explore all skills by this author →
GitHub

infra-queue

Audit AICP queue infrastructure and plan scalable queue migrations.

Updated Mar 26, 2026
Search Tags:#design#redis#queue#throughput#scaling#jsonl#dlq
One-click install
npx skills add https://github.com/cyberpunk042/devops-expert-local-ai --skill infra-queue
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: infra-queue
Source: https://github.com/cyberpunk042/devops-expert-local-ai/tree/main/.claude/skills/infra-queue
Command: npx skills add https://github.com/cyberpunk042/devops-expert-local-ai --skill infra-queue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manage AICP's queue surfaces — primary is the per-day JSONL Dead-Letter Queue (~/.aicp/dlq/); secondary is the in-process task_manager queue (aicp/core/tasks.py); future fleet integration may add a real message queue. Distinct from aicp-ops-dlq (DLQ runtime ops via CLI) — this skill is the design/scale lifecycle for queue infrastructure. Loads when the operator says "scale the queue" / "replace DLQ with Redis" / "add a queue for fleet" / "queue throughput limit" / "is JSONL DLQ enough".

Core Features & Use Cases

  • Audit current queue throughput vs scale assumptions; decide if JSONL DLQ suffices.
  • Plan migration to a real queue (Redis Streams, RabbitMQ, Kafka) with design decisions and adapters.
  • Add a fleet-wide messaging queue surface for inter-agent delivery.
  • Tune DLQ configuration within current scale (max_entries, max_retries, retry_delay_seconds) before migration.

Quick Start

Draft a throughput assessment and migration plan for the per-day JSONL DLQ.

Frequently Asked Questions about infra-queue

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

FAQPage Schema
How do I assess if my JSONL Dead-Letter Queue is sufficient for scaling?▼

To assess DLQ throughput, audit current queue scale assumptions against per-day JSONL limits. This skill generates a throughput assessment to determine if your file-based queue infrastructure can handle increased load or needs migration.

How do I plan a DLQ migration to Redis Streams or RabbitMQ?▼

Plan a DLQ migration by generating design decisions and adapter workstreams for real message queues. This skill creates a migration plan evaluating Redis Streams, RabbitMQ, or Kafka to replace file-based queue infrastructure.

What is the best way to tune DLQ configuration before scaling up?▼

Tune DLQ configuration by adjusting max_entries, max_retries, and retry_delay_seconds via the existing config system. This skill guides tuning operations to optimize current queue limits before committing to a migration.

When do I need to add a fleet-wide queue for inter-agent delivery?▼

Add a fleet-wide queue when scaling requires inter-agent messaging across multiple surfaces. This skill designs and plans the addition of fleet-wide queue infrastructure to support distributed agent delivery.

What are the limitations of using a JSONL file-based Dead-Letter Queue at scale?▼

JSONL DLQ limitations include throughput constraints and file-system bottlenecks at high scale. This skill audits these limits and documents a decision flow for when to retain JSONL or migrate to a real message queue.

Related Skills

Explore More Software Engineering Skills→
rsmdtrsmdt
381

performance-profiling

Diagnose performance issues by profiling CPU, memory, and I/O metrics.

Community
Advanced
jota-batutajota-batuta

message-queues

Standardize asynchronous messaging with idempotent consumers and dead-letter queues.

Community
Advanced
david-2814david-2814
3

sqs

Manage Amazon SQS queues, messages, DLQs, and policies via AWS CLI.

Community
Advanced
chavangorakh1999chavangorakh1999
1

message-queue-design

Design message queue systems with Bull/BullMQ, RabbitMQ, SQS, or Kafka.

Community
Advanced