PlugWiki

microservices-patterns skill (wshobson) for Claude Code: design distributed systems

microservices-patterns helps Claude design service boundaries, messaging and failure handling for a microservices system.

Installs
13.5K
on skills.sh
Stars
42.1K
on GitHub
Files
1
besides SKILL.md
Updated
Oct 2026
last repo commit

microservices-patterns is a skill from wshobson/agents. It loads when you decompose a monolith, define service contracts or design distributed systems. SKILL.md covers four areas: how to split services, how they communicate, how data is managed, and how they stay resilient.

A second file, references/details.md, holds worked examples: order, payment and inventory services, an API gateway, REST and Kafka-based communication, a saga for order fulfillment and a circuit breaker. The skill bundles no scripts.

Good for

  • Teams breaking a monolith into services
  • Architects defining service boundaries and contracts
  • Developers adding Kafka events, sagas or circuit breakers

Install microservices-patterns

Claude Code

  1. 1

    Copy this prompt.

    Install the microservices-patterns skill in Claude Code. Run this command:

npx skills add wshobson/agents --skill microservices-patterns

Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

Built from the package data we hold. Not yet tested by us. Source.

What's in the skill

When it loads

Design microservices architectures with service boundaries, event-driven communication, and resilience patterns. Use when building distributed systems, decomposing monoliths, or implementing microservices.

Sections in SKILL.md

  1. When to Use This Skill
  2. Core Concepts
  3. 1. Service Decomposition Strategies
  4. 2. Communication Patterns
  5. 3. Data Management
  6. 4. Resilience Patterns
  7. Detailed patterns and worked examples

Key facts

Author
wshobson (GitHub account that owns the repo)
Source repo
wshobson/agents
Installs on skills.sh
13,460 as of 2026-11-02
GitHub stars
42,081 (whole repo) as of 2026-11-02
License
MIT
Last repo commit
2026-10-30
Files
2 files including SKILL.md (plus references/details.md)
skills.sh audits
Gen Agent Trust Hub pass, Socket pass, Snyk pass

What it includes

  • By business capability, by DDD subdomain, or gradually with the strangler fig pattern.

    Service decomposition

  • Synchronous (REST, gRPC, GraphQL) and asynchronous (Kafka, RabbitMQ, SQS, pub/sub).

    Communication patterns

  • Database per service, and the saga pattern with compensating actions.

    Data management

  • Circuit breaker, retry with exponential backoff, and bulkhead.

    Resilience patterns

  • Business-capability services, API gateway, REST and Kafka calls, saga, circuit breaker.

    Worked examples (references/details.md)

From the official docs

Permissions

Low risk

This skill is Markdown instructions with no bundled scripts. The plugin route installs more than the skill, so pick the skills CLI command if you want only this one.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • The plugin route adds more than this skill

    The backend-development plugin folder holds 9 skills, 8 agent file(s) and 1 command file(s), plus plugin.json files. The repo tree shows no hooks or MCP config in it. The skills CLI route installs only this skill. github.com

Questions

How do I install the microservices-patterns skill?

Use the install box above. The skills CLI command installs only this skill. The plugin route installs backend-development, which also holds eight other skills, eight agent files and a command file.

What does microservices-patterns cover?

It covers service decomposition, communication, data management and resilience. The tool list above names each pattern. The details file adds worked examples for an e-commerce system.

Does it need setup or an API key?

The skill is Markdown only and bundles no scripts. Neither file asks for an API key. The text mentions Kafka, RabbitMQ and SQS, which your own system would need if you build with them.

Are the examples only in Python?

SKILL.md names no language. The worked examples in references/details.md are Python and use FastAPI, httpx, aiokafka, tenacity and circuitbreaker.

Does it work in the Claude app or Codex?

The install box lists a zip upload for the Claude app and a plugin route for Codex. The wshobson/agents README names Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot and Pi as supported tools.

Is microservices-patterns safe to install?

The skill is two Markdown files with no scripts, so installing it alone adds instructions only. The plugin route adds more skills, agents and a command, listed in the safety section.

Information

updated Nov 2, 2026

Repository
wshobson/agents
Folder
plugins/backend-development/skills/microservices-patterns

wshobson/agentsskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6
  1. wshobson/agents README · github.com
  2. Claude Code skills · code.claude.com
  3. Using skills in Claude · support.claude.com
  4. microservices-patterns SKILL.md · github.com
  5. details.md · github.com
  6. microservices-patterns on skills.sh · skills.sh

Updated Nov 2, 2026.