sqs-queue-auditor

Audit AWS SQS queue configurations for silent message loss and redelivery risks.

17|Updated May 15, 2026
One-click install
npx skills add https://github.com/anyshift-io/sre-skills --skill sqs-queue-auditor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sqs-queue-auditor
Source: https://github.com/anyshift-io/sre-skills/tree/main/skills/sqs-queue-auditor
Command: npx skills add https://github.com/anyshift-io/sre-skills --skill sqs-queue-auditor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

SQS queues can appear healthy in the console while silently dropping or re-delivering messages due to non-obvious configuration interactions. This skill encodes senior SRE judgment to catch the misconfigurations that standard checks miss, such as DLQ retention shorter than source retention or poison messages aging out before reaching the DLQ.

Core Features & Use Cases

  • Redrive Path Audit: Validates DLQ presence, maxReceiveCount band (3-10), and the critical retention ordering between source and DLQ that causes silent message loss.
  • Message Lifecycle Analysis: Detects poison messages aging out before reaching the DLQ, default visibility timeouts, and retention shorter than a plausible outage.
  • Exposure & FIFO Checks: Flags open resource policies, disabled encryption, and FIFO deduplication contract gaps.
  • Use Case: An engineer investigating missing messages in a payments or order-processing queue can run this audit against GetQueueAttributes output to identify whether the dead-letter path is actually wired correctly.

Quick Start

Use the sqs-queue-auditor skill to review the attached GetQueueAttributes output for your SQS queue and report any misconfigurations that could silently drop or re-deliver messages.

Frequently Asked Questions about sqs-queue-auditor

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

FAQPage Schema
Why are my AWS SQS messages silently dropping before reaching the dead-letter queue?

Silent SQS message loss often occurs when DLQ retention is shorter than source queue retention, causing messages to age out before redrive. An SQS queue audit evaluates GetQueueAttributes output to identify this critical retention ordering misconfiguration.

How do I audit an SQS queue configuration for a pre-deployment review?

You audit SQS queue configurations by analyzing GetQueueAttributes output against a deterministic nine-rule methodology. This validates redrive path wiring, message lifecycle timing, resource policy exposure, and FIFO invariants to catch silent dropping or re-delivery issues.

What SQS misconfigurations cause poison messages to be lost instead of redelivered?

Poison messages are lost when message lifecycle timing allows them to age out before reaching the DLQ. An SQS audit detects default visibility timeouts and retention periods shorter than plausible outages that prevent proper dead-letter redrive behavior.

How do I check if my SQS FIFO deduplication contract has configuration gaps?

To check FIFO deduplication gaps, evaluate SQS GetQueueAttributes output against FIFO invariant rules. The audit flags configuration issues that violate the deduplication contract, alongside checking for open resource policies and disabled encryption.

What is the correct maxReceiveCount band for an SQS dead-letter queue?

The correct maxReceiveCount band for an SQS dead-letter queue is between 3 and 10. An SQS redrive path audit validates this setting within GetQueueAttributes output to ensure poison messages are neither dropped prematurely nor retried excessively.

Can I use an SQS queue audit to investigate missing messages in a payments queue?

Yes, you can run an SQS queue audit against GetQueueAttributes output for a payments or order-processing queue. It identifies whether the dead-letter path is wired correctly and flags exposure risks that could silently drop or re-deliver messages.