agentleFS
wrg32786wrg32786/aigent-os/skills/ship-adapter/SKILL.md

ship-adapter

Skill25 starsChanged 7 days agoMITView on GitHub

Port schemas, interfaces, and API contracts into adapters. Use when writing a DB adapter, API client wrapper, interface adapter, or data transformer.

The file

We split this skill into the rules it gives an agent

7 rules. About 0 are common, 7 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈7

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Write an adapter that translates between two known interfaces.

    line 26
  2. Distinctive:

    If ambiguous, ask ONE question.

    line 39
  3. Distinctive:

    Read the source type/schema definition

    line 43
  4. Distinctive:

    Read the target type/schema definition

    line 44
  5. Distinctive:

    Add a comment for any non-obvious field mapping

    line 50
  6. Distinctive:

    Read source and target types before writing a single line.

    line 68
  7. Distinctive:

    No silent field drops — every unmapped field gets a comment.

    line 69

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.