reactor-sub-agent

Automate Reactor-style event handler design and validation from specification directories.

2|Updated Dec 24, 2025
One-click install
npx skills add https://github.com/knowlet/skills --skill reactor-sub-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reactor-sub-agent
Source: https://github.com/knowlet/skills/tree/main/skills/reactor-sub-agent
Command: npx skills add https://github.com/knowlet/skills --skill reactor-sub-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill focuses on Reactive/Integration Frame (RIF) patterns, designing event handlers, idempotency controls, retry and dead-letter strategies, and asynchronous integration points.

Core Features & Use Cases

  • Event Handler design: interface and input models for events.
  • Idempotency & retries: idempotence keys and retry strategies.
  • Integration safety: timeouts, circuit breakers, dead-letter handling.

Quick Start

Provide a docs/specs/order-created-handler.yaml to generate an OrderCreatedHandler skeleton.

Frequently Asked Questions about reactor-sub-agent

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

FAQPage Schema
How do I design event handlers with idempotency and retry logic?

Event handlers with idempotency use unique keys to prevent duplicate processing when messages are retried. This Skill automates handler design by reading your specification files and generating skeletons that enforce idempotency keys, exponential backoff retry strategies, and transactional boundaries for both durable and ephemeral subscriptions.

What's the best way to handle failed events in reactive systems?

Dead-letter queues (DLQ) capture events that fail after retries, preventing message loss. This Skill designs handlers that route failed events to DLQs with configurable timeouts and circuit breakers, ensuring failed events are isolated and can be analyzed without blocking the primary event stream.

Can I automate Reactor event handler code generation from specifications?

Yes. This Skill reads docs/specs/, frame.yaml, and requirements/ directories to automatically generate event handler skeletons with idempotency controls, retry policies, and DLQ routing pre-configured. You provide the specification; the Skill produces validated code matching your event integration patterns.

How do I ensure event handlers remain transactional across retries?

Transactional boundaries prevent partial state changes when events are retried. This Skill validates handler implementations against your machine/reactor.yaml configuration to enforce transactional settings, ensuring idempotency keys and retry logic work within atomic transaction scopes.

What happens when an event handler exceeds its retry limit?

After exponential backoff retries are exhausted, events move to the dead-letter queue for manual inspection. This Skill designs handlers that implement this fallback automatically, with configurable retry attempts and DLQ forwarding rules defined in your specification.