AGENT SKILL
pm-amazon-sqs
Amazon SQS connector knowledge and safe action guide.
- License 许可
- AGPL-3.0
- 最近更新
- 2026-09-21
- Stars
- ★ 7
- Forks
- 0
01 前言 Front Matter
- name
- pm-amazon-sqs
- description
- Amazon SQS connector knowledge and safe action guide.
03 SKILL.md 正文
pm-amazon-sqs
Purpose
Reads Amazon SQS queues and executes typed, approval-gated SQS message and queue actions through fixed AWS Query API operations.
Icon
- id: amazon-sqs
- asset: icons/amazon-sqs.svg
- source: upstream_registry
- review_status: upstream_seeded
Capabilities
- check=true catalog=true read=true write=true query=false
- Integration type: queue
Authentication
- Use pm credentials add with --from-env or --value-stdin for secret fields.
Configuration
- queue_url
- region
- endpoint_url
- max_batch_size
- max_wait_time
- visibility_timeout
- attributes_to_return
- system_attributes_to_return
- max_polls
- mode
- access_key (secret)
- secret_key (secret)
- session_token (secret)
ETL Streams
- messages: Messages received from the configured SQS queue. The connector does not delete messages.
- primary key: message_id
- fields: message_id(string), md5_of_body(string), receipt_handle(string), body(object), sent_timestamp(string), approximate_receive_count(string), sender_id(string), sequence_number(string), message_group_id(string), message_deduplication_id(string)
Sync Modes
- ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped
Reverse ETL Actions
- add_permission:
- endpoint: POST SQS.AddPermission
- required fields: label, aws_account_ids, actions
- risk: adds an SQS queue resource policy permission statement for listed AWS account ids
- cancel_message_move_task:
- endpoint: POST SQS.CancelMessageMoveTask
- required fields: task_handle
- risk: cancels an in-flight dead-letter-queue message move task
- change_message_visibility:
- endpoint: POST SQS.ChangeMessageVisibility
- required fields: receipt_handle, visibility_timeout
- risk: changes the visibility timeout for one in-flight message
- change_message_visibility_batch:
- endpoint: POST SQS.ChangeMessageVisibilityBatch
- required fields: receipt_handle, visibility_timeout
- optional fields: id
- risk: changes visibility timeout for up to 10 in-flight messages per SQS batch request
- create_queue:
- endpoint: POST SQS.CreateQueue
- required fields: queue_name
- optional fields: attributes, tags
- risk: creates an SQS queue; SQS returns an existing queue URL when name and attributes match
- delete_message:
- endpoint: POST SQS.DeleteMessage
- required fields: receipt_handle
- risk: deletes one received message by receipt handle
- delete_message_batch:
- endpoint: POST SQS.DeleteMessageBatch
- required fields: receipt_handle
- optional fields: id
- risk: deletes up to 10 received messages per SQS batch request
- delete_queue:
- endpoint: POST SQS.DeleteQueue
- risk: deletes the configured SQS queue
- purge_queue:
- endpoint: POST SQS.PurgeQueue
- risk: purges all available messages from the configured queue
- remove_permission:
- endpoint: POST SQS.RemovePermission
- required fields: label
- risk: removes an SQS queue resource policy permission statement
- send_message:
- endpoint: POST SQS.SendMessage
- required fields: message_body
- optional fields: delay_seconds, message_attributes, message_system_attributes, message_deduplication_id, message_group_id
- risk: sends one message to the configured queue; FIFO queues may use message_deduplication_id for provider-supported idempotency
- send_message_batch:
- endpoint: POST SQS.SendMessageBatch
- required fields: message_body
- optional fields: id, delay_seconds, message_attributes, message_system_attributes, message_deduplication_id, message_group_id
- risk: sends up to 10 messages per SQS batch request; FIFO queues may use message_deduplication_id for provider-supported idempotency
- set_queue_attributes:
- endpoint: POST SQS.SetQueueAttributes
- required fields: attributes or attribute_name + attribute_value
- risk: sets typed SQS queue attributes such as policy, redrive, encryption, retention, and visibility settings
- start_message_move_task:
- endpoint: POST SQS.StartMessageMoveTask
- required fields: source_arn
- optional fields: destination_arn, max_number_of_messages_per_second
- risk: starts an SQS dead-letter queue redrive message move task
- tag_queue:
- endpoint: POST SQS.TagQueue
- required fields: tags or tag_key + tag_value
- risk: adds or updates tags on the configured SQS queue
- untag_queue:
- endpoint: POST SQS.UntagQueue
- required fields: tag_keys
- risk: removes tags from the configured SQS queue
Security
- read risk: signed, bounded Amazon SQS Query API reads against the configured queue or derived regional endpoint; ReceiveMessage can change message visibility per SQS semantics
- write risk: typed SendMessage, queue administration, permission, tag, visibility, delete, purge, and dead-letter redrive operations against fixed SQS targets only
- approval: all reverse ETL/provider write commands require plan, preview, explicit approval, and destructive confirmation for delete/purge/cancel/remove operations
- Never pass secret values in chat, shell arguments, logs, docs, or JSON output.
Command Surface
- Inspect and safely operate Amazon SQS queues through fixed typed commands.
- Usage: pm amazon-sqs <command> [options]
- Source CLI: AWS CLI sqs (https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_Operations.html)
- Global flags:
- --approval-token-stdin (boolean): Read the approval token as one bounded line from standard input.
- Read
- Typed write/admin actions
- Other Commands
- messages receive - Read bounded messages from the configured queue without deleting them. [intent=etl availability=implemented stream=messages]
- queue attributes - Read selected attributes for the configured queue. [intent=direct_read availability=implemented operation=get_queue_attributes]; flags: --attribute-names, --page, --page-cursor
- queue url - Resolve a queue URL by queue name and optional owner account id. [intent=direct_read availability=implemented operation=get_queue_url]; flags: --queue-name (required, non-empty), --queue-owner-aws-account-id (non-empty), --page, --page-cursor
- queues list - List queue URLs in the configured region endpoint. [intent=direct_read availability=implemented operation=list_queues]; flags: --queue-name-prefix (non-empty), --max-results, --page, --page-cursor
- queue tags - Read tags for the configured queue. [intent=direct_read availability=implemented operation=list_queue_tags]; flags: --page, --page-cursor
- dead-letter-source-queues list - List queues configured with the current queue as a dead-letter queue. [intent=direct_read availability=implemented operation=list_dead_letter_source_queues]; flags: --max-results, --page, --page-cursor
- message-move-tasks list - List recent dead-letter message move tasks for a source queue ARN. [intent=direct_read availability=implemented operation=list_message_move_tasks]; flags: --source-arn (required, non-empty), --max-results, --page, --page-cursor
- permission add - Plan a typed Amazon SQS add permission operation. [intent=reverse_etl availability=implemented write=add_permission]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute; risk: adds an SQS queue resource policy permission statement for listed AWS account ids; flags: --label (required, non-empty), --aws-account-ids (required), --actions (required)
- message-move-task cancel - Plan a typed Amazon SQS cancel message move task operation. [intent=reverse_etl availability=implemented write=cancel_message_move_task]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute; risk: cancels an in-flight dead-letter-queue message move task; flags: --task-handle (required, non-empty)
- message change-visibility - Plan a typed Amazon SQS change message visibility operation. [intent=reverse_etl availability=implemented write=change_message_visibility]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute; risk: changes the visibility timeout for one in-flight message; flags: --receipt-handle (required, non-empty), --visibility-timeout (required)
- message change-visibility-batch - Plan a typed Amazon SQS change message visibility batch operation. [intent=reverse_etl availability=implemented write=change_message_visibility_batch]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute; risk: changes visibility timeout for up to 10 in-flight messages per SQS batch request; flags: --id (non-empty), --receipt-handle (required, non-empty), --visibility-timeout (required)
- queue create - Plan a typed Amazon SQS create queue operation. [intent=reverse_etl availability=implemented write=create_queue]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute; risk: creates an SQS queue; SQS returns an existing queue URL when name and attributes match; flags: --queue-name (required, non-empty)
- message delete - Plan a typed Amazon SQS delete message operation. [intent=reverse_etl availability=implemented write=delete_message]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute; risk: deletes one received message by receipt handle; flags: --receipt-handle (required, non-empty)
- message delete-batch - Plan a typed Amazon SQS delete message batch operation. [intent=reverse_etl availability=implemented write=delete_message_batch]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute; risk: deletes up to 10 received messages per SQS batch request; flags: --id (non-empty), --receipt-handle (required, non-empty)
- queue delete - Plan a typed Amazon SQS delete queue operation. [intent=reverse_etl availability=implemented write=delete_queue]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute; risk: deletes the configured SQS queue
- queue purge - Plan a typed Amazon SQS purge queue operation. [intent=reverse_etl availability=implemented write=purge_queue]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute; risk: purges all available messages from the configured queue
- permission remove - Plan a typed Amazon SQS remove permission operation. [intent=reverse_etl availability=implemented write=remove_permission]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute; risk: removes an SQS queue resource policy permission statement; flags: --label (required, non-empty)
- message send - Plan a typed Amazon SQS send message operation. [intent=reverse_etl availability=implemented write=send_message]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute; risk: sends one message to the configured queue; FIFO queues may use message_deduplication_id for provider-supported idempotency; flags: --message-body (required, non-empty), --delay-seconds, --message-deduplication-id (non-empty), --message-group-id (non-empty)
- message send-batch - Plan a typed Amazon SQS send message batch operation. [intent=reverse_etl availability=implemented write=send_message_batch]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute; risk: sends up to 10 messages per SQS batch request; FIFO queues may use message_deduplication_id for provider-supported idempotency; flags: --id (non-empty), --message-body (required, non-empty), --delay-seconds, --message-deduplication-id (non-empty), --message-group-id (non-empty)
- queue set-attributes - Plan a typed Amazon SQS set queue attributes operation. [intent=reverse_etl availability=implemented write=set_queue_attributes]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute; risk: sets typed SQS queue attributes such as policy, redrive, encryption, retention, and visibility settings; flags: --attribute-name (required, non-empty), --attribute-value (required, non-empty)
- message-move-task start - Plan a typed Amazon SQS start message move task operation. [intent=reverse_etl availability=implemented write=start_message_move_task]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute; risk: starts an SQS dead-letter queue redrive message move task; flags: --source-arn (required, non-empty), --destination-arn (non-empty), --max-number-of-messages-per-second
- queue tag - Plan a typed Amazon SQS tag queue operation. [intent=reverse_etl availability=implemented write=tag_queue]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute; risk: adds or updates tags on the configured SQS queue; flags: --tag-key (required, non-empty), --tag-value (required, non-empty)
- queue untag - Plan a typed Amazon SQS untag queue operation. [intent=reverse_etl availability=implemented write=untag_queue]; approval: reverse ETL writes require plan -> preview -> explicit approval -> execute; risk: removes tags from the configured SQS queue; flags: --tag-keys (required)
- Help topics:
- safety - Amazon SQS write commands always use reverse ETL plan, preview, approval, and execute; destructive commands require typed confirmation.
Commands
Inspect as a manual
pm connectors inspect amazon-sqs
Inspect as structured JSON
pm connectors inspect amazon-sqs --json
Agent Rules
- Run pm connectors inspect amazon-sqs before creating credentials or plans.
- Use --json only when the caller needs structured output; use the manual for human-readable guidance.
- Never ask the user to paste secret values into chat.
- For reverse ETL writes, create a plan, show the preview, wait for explicit approval, then run with the approval token.
04 同仓库更多 Skills
recipe-preview-approve-reverse-etl
Preview and approve a reverse ETL plan safely.
★ 7
recipe-github-prs-to-warehouse
Sync GitHub pull requests into the local warehouse.
★ 7
pm-zoom
Zoom connector knowledge and safe action guide.
★ 7
pm-zonka-feedback
Zonka Feedback connector knowledge and safe action guide.
★ 7
pm-zoho-invoice
Zoho Invoice connector knowledge and safe action guide.
★ 7
pm-zoho-inventory
Zoho Inventory connector knowledge and safe action guide.
★ 7