commerce-events

Inspect and replay commerce events, idempotency keys, and outbox states for debugging.

Updated Jan 19, 2026
One-click install
npx skills add https://github.com/stateset/icommerce-skills --skill commerce-events
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: commerce-events
Source: https://github.com/stateset/icommerce-skills/tree/main/skills/commerce-events
Command: npx skills add https://github.com/stateset/icommerce-skills --skill commerce-events

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Inspect and debug the commerce event history, audit trails, and idempotency keys to prevent duplicate actions and improve reliability.

Core Features & Use Cases

  • Inspect the event log for any commerce entity and view payloads and metadata
  • Review the outbox for pending and synced events and manage idempotency keys
  • Replay or acknowledge events to validate recovery and ensure end-to-end visibility

Quick Start

Query the event history for a specific event_id or entity to quickly verify the audit trail and idempotent behavior.

Frequently Asked Questions about commerce-events

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

FAQPage Schema
How do I debug duplicate actions in commerce event workflows?

Debug duplicate actions in commerce event workflows by inspecting the event history and querying idempotency keys to verify that retries are properly controlled. You can list, inspect, and acknowledge events to validate recovery across orders, payments, and inventory.

How do I inspect event payloads for specific commerce entities?

Inspect event payloads for specific commerce entities by querying the event log with a specific event ID or entity identifier. This allows you to quickly verify the audit trail, view metadata, and diagnose issues across outbox workflows.

What's the best way to replay pending events in an outbox?

Replay pending events in an outbox by reviewing the outbox state for synced or pending items and applying the replay action. You can then acknowledge the events to validate recovery and ensure end-to-end visibility for commerce operations.

Why does my commerce payment event show inconsistent audit history?

Commerce payment events show inconsistent audit history when idempotency controls fail to prevent duplicate processing. Query the idempotency keys and outbox states to identify pending or synced events causing the discrepancy in the audit trail.

Can I query idempotency keys to prevent duplicate order processing?

You can query idempotency keys to prevent duplicate order processing by reviewing the stored keys and their associated states. This helps identify and diagnose issues where retries may result in duplicate actions across commerce workflows.

When do I need to acknowledge events in commerce workflows?

Acknowledge events in commerce workflows after replaying them to validate recovery and ensure end-to-end visibility. This action confirms that pending outbox events have been properly processed and prevents further duplicate actions.