Does it support different communication protocols?

Yes, it can be used to generate integrations for various protocols including REST (HTTP), RPC, or vendor-specific SDKs.

What architecture does this skill support?

It is specifically designed for Java Domain-Driven Design (DDD) projects following a ports-and-adapters (hexagonal) architecture, specifically within the Persimmon scaffold.

How does it handle external API errors?

The skill generates implementation logic to translate protocol-level errors (like HTTP 404 or 500) into domain-meaningful failures, allowing for clear retry and recovery classification.

Can it update my Spring configuration?

Yes, the skill includes logic to generate wiring configurations for Spring beans and can update YAML configuration files for necessary system keys.

Where is the generated code placed?

Code is organized under the infra.gateway. package, maintaining a clear system-first hierarchy that separates client logic from domain implementations.

Java Infrastructure Gateway Generator

Name: Java Infrastructure Gateway Generator
Author: ryan-alexander-zhang

byryan-alexander-zhang

0•

API Development

Generates standardized external integration layers for Java DDD projects, including clients, DTOs, and error translation rules.

This skill automates the creation of external system integrations within a Domain-Driven Design (DDD) architecture. It follows a system-first organization pattern to generate protocol-specific clients, integration DTOs, and gateway implementations that map to domain ports. By enforcing a clear separation between infrastructure details and business logic, it ensures that external failures are translated into meaningful domain errors and prevents protocol-specific models from leaking into the application core. It is ideal for developers using the Persimmon scaffold who need to integrate with external APIs, cloud services, or internal microservices while maintaining clean architecture principles.

Key Features

01Configurable retry policies and timeouts defined at the client level for resilient integrations

02Automatic wiring of gateway beans and YAML configuration updates via integrated generators

03Automated generation of system-first infrastructure layers (client, DTO, and implementation)

04Enforces strict separation of concerns between protocol details and business-oriented domain ports

050 GitHub stars

06Built-in error translation patterns for converting protocol failures into domain-specific exceptions

Use Cases

01Implementing domain gateway ports while maintaining a clean hexagonal architecture

02Integrating external services like Kubernetes, Harbor, or payment gateways into a Java DDD backend

03Standardizing error handling and retry logic across multiple third-party API integrations

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ryan-alexander-zhang/persimmon infra-system-gateway-generator

For use in Claude.ai and ChatGPT

Download Skill