migrate-to-shoehorn SKILL.md skillA

migrate-to-shoehorn from mxyhi/ok-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

mdr add mxyhi/ok-skills/migrate-to-shoehorn@git:20260427.26d456f

Pins git:20260427.26d456f in mdr.lock. Pin the fingerprint instead.

Audit grade

A, 17 of 17 checks passed

Kind

SKILL.md skill

Repository

mxyhi/ok-skills

Path

migrate-to-shoehorn/SKILL.md

Versions recorded

1

Latest version

git:20260427.26d456f, committed Apr 27, 2026

Size

2,795 bytes

Repository stars

504

License

Apache-2.0

Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Migrate to Shoehorn

## Why shoehorn?

`shoehorn` lets you pass partial data in tests while keeping TypeScript happy. It replaces `as` assertions with type-safe alternatives.

**Test code only.** Never use shoehorn in production code.

Problems with `as` in tests:

- Trained not to use it
- Must manually specify target type
- Double-as (`as unknown as Type`) for intentionally wrong data

## Install

```bash
npm i @total-typescript/shoehorn
```

## Migration patterns

### Large objects with few needed properties

Before:

```ts
type Request = {
  body: { id: string };
  headers: Record<string, string>;
  cookies: Record<string, string>;
  // ...20 more properties
};

it("gets user by id", () => {
  // Only care about body.id but must fake entire Request
  getUser({
    body: { id: "123" },
    headers: {},
    cookies: {},
    // ...fake all 20 properties
  });
});
```

After:

```ts
import { fromPartial } from "@total-typescript/shoehorn";

it("gets user by id", () => {
  getUser(
    fromPartial({
      body: { id: "123" },
    }),
  );
});
```

### `as Type` → `fromPartial()`

Before:

```ts
getUser({ body: { id: "123" } } as Request);
```

After:

```ts
…

Read the whole file at its exact version.

How to install

mdr add mxyhi/ok-skills/migrate-to-shoehorn@sha256:de4da4c11d924fac

[![mdr](https://markdownregistry.com/badge/art_a347cfkqyv6dzqdn.svg)](https://markdownregistry.com/a/art_a347cfkqyv6dzqdn)

Versions

The registry has recorded 1 version of this file, committed on Apr 27, 2026.

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_a347cfkqyv6dzqdn
GET https://markdownregistry.com/api/v1/resolve?ref=mxyhi/ok-skills/migrate-to-shoehorn
GET https://markdownregistry.com/api/v1/blob/de4da4c11d924fac79c924b2ee3d2db4a5cb98386eb490a599119463d036ae72

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from mxyhi/ok-skills

Every file in mxyhi/ok-skills

Other files named migrate-to-shoehorn

Browse by kind, by grade A, or by owner.