Back to Skills
Skill

implementing-service-integrations

From kotlin-building-blocks
1
Install
1
Install the plugin
$
npx claudepluginhub allousas/claude-code-plugins --plugin kotlin-building-blocks

Want just this skill?

Add to a custom plugin, then install with one command.

Description

Apply when creating, modifying, or reviewing any file that is an outbound HTTP client, REST client adapter, that integrates with an external service via sync http calls.

Tool Access

This skill uses the workspace's default tool permissions.

Supporting Assets
View in Repository
examples.md
Skill Content

Purpose

External service integrations translate domain calls into external API calls.

Typical Flow

  1. Receive domain parameters from the application service layer
  2. Map domain parameters to external API DTO if needed
  3. Call external REST API using an http client
  4. Map answer to http response DTO
  5. Handle happy case-scenario: map back to a domain entity if needed
  6. Handle non-happy case-scenarios
  7. return the result to the application service layer if needed

Guidelines

DO:

  • File naming: <ExternalSystem><EntityClientOrInterfaceImplemented>, e.g., HttpClientPeopleFinder
  • Throw infrastructure exceptions for non-successful responses (except 404, it will return null)
  • Map external API DTOs to domain entities using private functions
  • Use Mapper classes for complex mappings
  • Declare DTOs in the same file where they are used
  • If Retrofit is used, define Retrofit client interfaces in the same file below for cohesion

DON'T:

  • Leak http request/response dtos outside of the component, use only domain entities or primitives IN and OUT
  • Throw domain exceptions or return domain errors - those belong in domain/application layers
  • Include any business logic

Examples

Please use always these examples as reference: examples.md

Stats
Stars1
Forks0
Last CommitFeb 25, 2026
Actions

Similar Skills

cache-components

Expert guidance for Next.js Cache Components and Partial Prerendering (PPR). **PROACTIVE ACTIVATION**: Use this skill automatically when working in Next.js projects that have `cacheComponents: true` in their next.config.ts/next.config.js. When this config is detected, proactively apply Cache Components patterns and best practices to all React Server Component implementations. **DETECTION**: At the start of a session in a Next.js project, check for `cacheComponents: true` in next.config. If enabled, this skill's patterns should guide all component authoring, data fetching, and caching decisions. **USE CASES**: Implementing 'use cache' directive, configuring cache lifetimes with cacheLife(), tagging cached data with cacheTag(), invalidating caches with updateTag()/revalidateTag(), optimizing static vs dynamic content boundaries, debugging cache issues, and reviewing Cache Component implementations.

138.4k