Skip to main content
skill CX Codex

ship-adapter — Claude Code skill: adapters and installation

The ship-adapter Claude Code skill turns schemas and API contracts into adapters. It runs for database adapters, API client wrappers, interface adapters, and data transformers.

MIT ★ 26 updated 2026-11-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add wrg32786/aigent-os --skill ship-adapter -a claude-code
Open on GitHub

What ship-adapter does

The skill writes code that translates between two known interfaces, such as a database schema and an API response type. It reads both definitions and searches the project for adapter patterns before matching the existing error-handling style. Both sides of the contract are read before any code is written.

Null and optional fields get explicit handling, and unusual field mappings receive comments. The result includes a record of changed and untouched files, unresolved mapping issues, assumptions, and tradeoffs. Its scope ends at the adapter; infrastructure work goes back to the composing agent.

What it helps with

  • translate data between two schemas
  • wrap an API with a client interface
  • map database fields to a response type
  • handle null and optional fields in a transformation

Example prompts for the agent

  • Write an adapter from the UserRecord schema to the UserProfile response type.
  • Wrap this API in a client adapter that follows the project’s existing patterns.
  • Transform this schema to the target interface without dropping fields.

How to install ship-adapter

1Skills CLI (Vercel)

npx skills add wrg32786/aigent-os --skill ship-adapter -a claude-code

2Manually: put the files in place

~/.claude/skills/ship-adapter/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/ship-adapter/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about ship-adapter

How do I install ship-adapter in Claude Code?

Run npx skills add wrg32786/aigent-os --skill ship-adapter -a claude-code. The skill file is at ~/.claude/skills/ship-adapter/SKILL.md.

What does ship-adapter do?

It writes an adapter between two interfaces or schemas and follows patterns found in the project. It returns a record of the files changed and decisions made.

What happens to fields that have no mapping?

The skill does not silently discard them; it adds a comment for each unmapped field. It also comments on mappings that need explanation.

Source text

SKILL.md · MIT
---
name: ship-adapter
agent: lyra
description: "Port schemas, interfaces, and API contracts into adapters. Use when writing a DB adapter, API client wrapper, interface adapter, or data transformer."
allowed-tools: Read, Write, Edit, Bash, Grep, Glob, Agent
user-invocable: true
triggers:
  - ship adapter
  - port adapter
  - write adapter
  - DB adapter
  - API adapter
  - data transformer
  - schema migration
  - interface adapter
  - wrap this API
  - transform this schema
---

# Ship Adapter

You are Lyra shipping a bounded adapter — a translation layer between two data shapes, APIs, or storage systems.

## What this skill does

Write an adapter that translates between two known interfaces. Inputs: source shape + target shape + any behavioral constraints. Output: working adapter code + honesty ledger.

## Protocol

### Step 1: Confirm the contract

State in one sentence what is being adapted. Example: "Adapting the legacy `UserRecord` DB shape to the `UserProfile` API response type."

Identify:
- Source shape (where data comes from)
- Target shape (what consumers expect)
- Edge cases or nullability constraints called out in the spec

If ambiguous, ask ONE question. Then build.

### Step 2: Read both sides

- Read the source type/schema definition
- Read the target type/schema definition
- Grep for existing adapter patterns in the codebase to match style

### Step 3: Write the adapter

- Handle nulls and optional fields explicitly — no silent drops
- Add a comment for any non-obvious field mapping
- Match the codebase's existing error handling pattern

### Step 4: Return honesty ledger

```
## Honesty Ledger

**Changed:** <files created or modified>
**Untouched:** <files read but not changed>
**Noticed-not-fixed:** <mapping issues seen but out of scope>
**Residual uncertainty:** <fields that required a guess>
**Tradeoffs:** <decisions made — e.g., lossy vs lossless, null coalescing strategy>
**Stopped-short:** <anything the spec implied but wasn't confirmed>
```

## Constraints

- Read source and target types before writing a single line.
- No silent field drops — every unmapped field gets a comment.
- Scope boundary is the adapter itself. Infrastructure changes go back to the composer.

© wrg32786 · MIT · wrg32786/aigent-os

Similar skills

All skills for Backend and APIs →
prisma-driver-adapter-implementation prisma prisma-driver-adapter-implementation is a Claude Code skill and reference guide for implementing SQL adapters in Prisma ORM 7. It covers transactions, savepoints, value mapping, and database errors. CX Codex +1 425,600installs opencli-adapter-author jackwener opencli-adapter-author is a Claude Code skill for building and improving OpenCLI JS adapters from observed site behavior and browser evidence. It kicks in when a site needs a new command or an existing adapter needs work. CX Codex +1 16,600installs migration JuliusBrussee migration enforces reversible, compatibility-safe transitions for schema, data, and API updates. Useful whenever data loss or rollout downtime is unacceptable. CX Codex +1 127,700installs create-adapter harbor-framework create-adapter — a skill for Claude Code, Codex, Cursor and three more agents. Scaffolds a Harbor benchmark adapter with harbor adapter init and hands implementation off to the contributor guide. CX Codex +1 113installs skill-adapter Jeremy Longshore skill-adapter inspects repository plugins, extracts their methodologies, and applies those patterns to your current task. Useful when you need to combine techniques from multiple tools. CX Codex +1 7installs nemo-fabric-build-adapter NVIDIA nemo-fabric-build-adapter is a skill for developing and validating NVIDIA NeMo Fabric adapters against the platform contract, from descriptors and configuration mapping to lifecycle implementation and spec checks. CX Codex +1 ★ 4,106repo stars

From the same set58

The whole set →
solution-hunt The solution-hunt Claude Code skill finds legitimate alternatives when a task hits a blocker. It searches local notes and skills, then looks through GitHub and documentation. CX Codex +1 ★ 26repo stars skill-recall This Claude Code skill matches a task with local skills. Run /skill-recall to find candidates or record a gap when none fit. CX Codex +1 ★ 26repo stars skill-hunt The skill-hunt Claude Code skill finds skills that fill a capability gap. It ranks candidates, checks a selected skill, then installs it in quarantine. CX Codex +1 ★ 26repo stars Skill Audit The Skill Audit Claude Code skill checks skill usage and whether descriptions match the prompts that trigger them. It also flags idle skills and recurring work with no matching skill. CX Codex +1 ★ 26repo stars setup This Claude Code skill configures aigent-OS identity, priorities, and authority boundaries. Run /setup to configure the system or revise specific sections later. CX Codex +1 ★ 26repo stars semantic-search The semantic-search Claude Code skill searches an Obsidian vault by meaning using local embeddings. It runs for finding related notes or recalling what you wrote about a topic. CX Codex +1 ★ 26repo stars Self-Review The Self-Review Claude Code skill sends substantial code changes through a focused second review. It targets multi-file edits, hot paths, prompts, and work that still feels uncertain. CX Codex +1 ★ 26repo stars scout-vault The scout-vault Claude Code skill finds related vault notes, links, and code definitions. It runs for note discovery, vault inventory, or call-chain searches. CX Codex +1 ★ 26repo stars

Project sponsors

Companies that keep this analytics open