# java-microservices

Guides Java microservice design with Spring Cloud, covering event flows, resilience patterns, and tracing. Use it when shaping distributed services.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 498 installs · ★ 41
- Author: pluginagentmarketplace
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pluginagentmarketplace/custom-plugin-java/tree/HEAD/skills/java-microservices/SKILL.md
- Updated: 2026-01-05
- HTML: https://affpapa.org/en/nevibecode/skills/java-microservices

## What it does

The skill covers Spring Cloud building blocks, including service discovery with Eureka or Consul, API Gateway routing, and load balancing. Its examples show a Kafka-based Saga and a Resilience4j circuit breaker. Retry policies, bulkhead isolation, and rate limiting are also covered.

For observability, it describes Micrometer tracing, Prometheus metrics, and log correlation through trace IDs. Gateway route configuration and troubleshooting notes address issues such as lost messages and service discovery delays. The examples target Java and Spring Cloud; Kafka scenarios require messaging to be set up. Skill parameters let you select an architecture pattern and a messaging platform.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-java --skill java-microservices -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/java-microservices/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/java-microservices/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-java --skill java-microservices -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/java-microservices/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-java --skill java-microservices -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/java-microservices/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pluginagentmarketplace/custom-plugin-java java-microservices
```

2. **Manually: put the files in place**
- File: `.github/skills/java-microservices/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-java --skill java-microservices -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/pluginagentmarketplace/custom-plugin-java --path skills/java-microservices
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/java-microservices/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-java --skill java-microservices -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/pluginagentmarketplace/custom-plugin-java/tree/HEAD/skills/java-microservices/SKILL.md

## When to use it
- design communication between Java microservices
- configure Spring Cloud Gateway routes
- add a Resilience4j circuit breaker
- coordinate order events with a Kafka Saga
- diagnose lost messages or service discovery issues

## Example prompts
- Set up a Spring Cloud gateway for order requests and add circuit-breaker protection.
- Show how to coordinate order, inventory, and payment events with a Kafka Saga.
- Explain how to add Micrometer tracing and Prometheus metrics to these services.

## Similar
- [mcp-builder](https://affpapa.org/en/nevibecode/skills/mcp-builder.md) — skill · 130949 installs
- [claude-api](https://affpapa.org/en/nevibecode/skills/claude-api.md) — skill · 74198 installs
- [lark-im](https://affpapa.org/en/nevibecode/skills/lark-im.md) — skill · 472900 installs
- [lark-event](https://affpapa.org/en/nevibecode/skills/lark-event.md) — skill · 466800 installs
- [caveman-discover](https://affpapa.org/en/nevibecode/skills/caveman-discover.md) — skill · 104400 installs
- [migration](https://affpapa.org/en/nevibecode/skills/migration.md) — skill · 103900 installs

From the same set: [pluginagentmarketplace/custom-plugin-java](https://affpapa.org/en/nevibecode/by/pluginagentmarketplace/custom-plugin-java.md) — 9 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md