mcpbeat

Microservices

cosmicstack-labs/microservices

Service boundaries, communication patterns, event sourcing, CQRS, and distributed tracing

503 tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
365
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/cosmicstack-labs/mercury-agent-skills --skill microservices

The instruction itself

9 sections, as written by the author

Microservices

Design and operate microservice architectures.

Service Boundaries

Bounded Context (DDD)

  • Each service owns a domain concept
  • Service has its own database (no DB sharing)
  • Communication via API or events
  • Avoid "shared" services (leads to tight coupling)

Service Sizing

  • Too small: Nano-services — high overhead, hard to debug
  • Too large: Distributed monolith — worst of both worlds
  • Right size: Team can build, test, deploy independently

Communication Patterns

| Pattern | Type | When |

|---------|------|------|

| REST | Sync | Request-response, CRUD |

| gRPC | Sync (fast) | Internal, high throughput |

| Event | Async | Decoupled workflows |

| Message Queue | Async | Buffered, reliable delivery |

Event-Driven Communication

Service A → Event Bus → Service B
                       → Service C
                       → Service D

Benefits: eventual consistency, loose coupling, replayability.

CQRS (Command Query Responsibility Segregation)

  • Separate read and write models
  • Queries go to optimized read stores (materialized views)
  • Commands go to write stores (normalized)
  • Eventually consistent between them

Distributed Tracing

  • Correlation ID passed across all services
  • Use OpenTelemetry for instrumentation
  • Trace each request: Service → Queue → DB → External API
  • Visualize in Jaeger or Zipkin
  • Alert on traces that exceed latency SLOs

Anti-Patterns to Avoid

❌ Shared database between services

❌ Sync chains (A → B → C → D blocking)

❌ Distributed monolith (microservices but deployed together)

❌ Absent monitoring ("it works in dev")

❌ Premature decomposition (start monolith, extract carefully)

How to use it

Copy the folder

Take cosmicstack-labs/microservices from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.