review-services

Review local agent services for reliability, idempotency, and error handling.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/cesau78/cesau-skills --skill review-services
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-services
Source: https://github.com/cesau78/cesau-skills/tree/main/review-services
Command: npx skills add https://github.com/cesau78/cesau-skills --skill review-services

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviews local agent services (printing-agent MQTT, accounting-agent polling) for reliability, idempotency, error handling, and safe interaction with print_jobs and accounting data. Use when services/ changes, or when skills-advisor recommends this lens.

Core Features & Use Cases

  • Idempotency checks to prevent duplicate writes or inconsistent state across MQTT and polling cycles.
  • Failure mode analysis: partial writes, missing retries where safe, unbounded error loops, silent drops.
  • Concurrency safeguards: handling races when multiple workers or restarts process the same job.
  • Observability guidance: logging that's actionable without leaking secrets and provides meaningful error context.
  • Boundary alignment: verify correct Mongo collections and field names relative to shared data structures.

Quick Start

Run the review-services lens whenever you modify services or data flows to validate reliability and safe interactions.

Frequently Asked Questions about review-services

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

FAQPage Schema
How do I review agent services for reliability and error handling?

To review agent services for reliability, analyze failure modes like partial writes and silent drops, verify idempotency to prevent duplicate writes, and ensure safe interaction with data across MQTT and polling cycles.

What is idempotency in MQTT message processing and polling cycles?

Idempotency in MQTT and polling cycles ensures duplicate messages or retries do not cause inconsistent state or duplicate writes across Mongo collections, preventing duplicate accounting data or print jobs.

How do I prevent race conditions when multiple workers process the same job?

Prevent race conditions during concurrent job processing by applying concurrency safeguards that handle restarts and multiple workers safely interacting with shared Mongo collections and data structures.

Does this reliability review work with MongoDB collections and MQTT brokers?

Yes, this reliability review validates safe interaction with MongoDB collections and MQTT brokers, verifying correct field names, clear data boundaries, and robust handling of message passing and persistence.

What's the best way to add observability to agent services without leaking secrets?

Add observability to agent services by implementing actionable logging that provides meaningful error context for failures while ensuring logs do not leak secrets during message passing and polling operations.

Why does my accounting agent polling loop silently drop records or enter unbounded error loops?

Accounting agent polling loops silently drop records or enter unbounded error loops due to missing retries, partial writes, or inadequate failure mode analysis across Mongo collections and data flows.