Skip to content
cccskills
FreePublished on GitHub

async-ops

Webhook handling and background job scheduling for backend services

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3 stars(GitHub 3 + cccskills 0)
Works withRedis

Run score Not tested

See how to install

Files included (5)

  • SKILL.md2.6 KB
  • references/anti-patterns.md600 B
  • references/checklist.md544 B
  • references/job-scheduling.md1.4 KB
  • references/outbound-webhooks.md1.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

async-ops — Webhooks & Background Job Scheduling

Stack: Fastify + Prisma + PostgreSQL + Redis + BullMQ + Zod + TypeScript.

INBOUND WEBHOOKS (Receiving)

Flow: receive -> verify signature -> deduplicate -> enqueue -> respond 200 (< 2s). All processing async via queue.

Signature: use provider SDK when available. Custom: HMAC-SHA256 over timestamp.body. Require raw body access (verify before parsing). Always include timestamp in signed material.

Anti-replay: reject if timestamp differs from server time by > 5 minutes.

Idempotency: Redis SETNX with event ID as key, 7-day TTL. If exists, return 200 already_processed.

Inbound Checklist

  • Signature verified (HMAC-SHA256 or provider SDK)
  • Timestamp anti-replay (< 5 min drift)
  • Idempotency by event ID (Redis SETNX + TTL)
  • Enqueue + fast 200 — processing async
  • Structured log with event_id and trace_id
  • Secret rotation plan documented

OUTBOUND WEBHOOKS (Sending)

Transactional outbox pattern + HMAC signature + exponential backoff retry + DLQ.

→ Read references/outbound-webhooks.md for outbox pattern, payload format, retry schedule, subscriber management y SSRF prevention

JOB SCHEDULING & QUEUES

BullMQ + Redis default. Queues separated by criticality. Jobs idempotent with timeout.

→ Read references/job-scheduling.md for queue technology selection, job design principles, retry, scheduling, concurrency y graceful shutdown

SHARED PATTERNS

Idempotency: unique event/job ID as dedup key (Redis SETNX or BullMQ jobId). Pass idempotency keys to external providers. Check entity state before side effects.

Dead Letter Handling: store in DLQ table / BullMQ failed set. Alert on growth. Dashboard for inspection + replay. 30-day retention. Auto-disable sustained failures.

Observability: metrics for webhook_{inbound,outbound}_total, webhook_{outbox_pending,dlq_depth}, job_{enqueued,completed}_total, job_duration_seconds, queue_depth{state}. Propagate traceId in payloads. Structured logs with event_id, job_id, queue.

Alerts: rising queue/outbox depth (throughput insufficient), DLQ growth > N/min (systemic), subscriber failure > 5% (endpoint down), failed jobs/min > threshold (page on-call).

ANTI-PATTERNS

→ Read references/anti-patterns.md for lista completa (14 items)

Checklist

→ Read references/checklist.md for checklist completo (8 items)

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Plan, design, and implement A/B tests and experiments with statistical rigor. Covers hypothesis frameworks, sample sizing, metrics, and result analysis.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

Web/mobile accessibility decision guide: WCAG 2.2 AA, ARIA, keyboard nav, focus management, contrast, testing. Use for: a11y, accessibility, wcag, aria, screen reader, keyboard, contrast.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

Generate, iterate, and scale ad creative for paid advertising across Google, Meta, LinkedIn, and X. Covers platform specs, creative frameworks, and quality validation.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

Musica interactiva para juegos: layering vertical, re-secuenciacion horizontal, stingers, reglas de transicion con sync points, y mapeo de estados de gameplay a musica. Usar para: musica adaptativa, sistema de musica dinamica, transiciones musicales, combat music.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

Design multi-agent systems, create agent architectures, define communication patterns, and build autonomous agent workflows with structured evaluation frameworks.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

Inter-agent communication protocol for C-suite agent teams. Defines invocation syntax, loop prevention, isolation rules, response formats, and quality loops.

The English summary is being prepared. Showing the original description.

SebastianLuser/claude-code-arcane3Updated Oct 27, 2026

See all skills by SebastianLuser

Report a problem with this skill