Перевод тестов на shoehorn
Заменяет as и as unknown as в тестах на TypeScript на fromPartial и fromAny из @total-typescript/shoehorn, добавляет импорты и запускает проверку типов. Для случаев, когда тесты собирают объекты целиком или обманывают компилятор приведениями.
migrate-to-shoehorn- Автор
- Matt Pocock
- Источник
- mattpocock/skills/skills/misc/migrate-to-shoehorn @ abeeaf9
- Лицензия
- MIT · Copyright (c) 2026 Matt Pocock
Об этом скилле
Что делает
Скилл переводит тесты на TypeScript с приведений типов через as на библиотеку @total-typescript/shoehorn, которая позволяет передавать в тестах неполные данные. Приведения заменяют три функции:
fromPartial()вместоas Type— для большого объекта, из которого тесту нужна пара полей: запрос с двадцатью свойствами, когда проверяемый код читает толькоbody.id.fromAny()вместоas unknown as Type— для намеренно неверных данных; автодополнение при этом продолжает работать.fromExact()требует объект целиком, а позже его можно заменить наfromPartial().
Сначала агент спрашивает, в каких тестах мешают приведения, большие ли там объекты при немногих нужных полях и передаёте ли вы заведомо неверные данные, чтобы проверить ошибки. Потом ставит пакет, ищет кандидатов через grep -r " as [A-Z]" по *.test.ts и *.spec.ts, заменяет приведения, добавляет импорты и запускает проверку типов.
Скилл — один SKILL.md с примерами «до» и «после»; в agents/openai.yaml — название и краткое описание для Codex.
Когда включать и когда не надо
В проекте на TypeScript, где тесты пестрят as и as unknown as или где каждый тест собирает объект целиком только ради компилятора.
Не для рабочего кода: в скилле прямо сказано, что shoehorn — только для тестов. Пакет ставится обычным npm i без -D, так что скажите, если он нужен в devDependencies или у вас другой менеджер пакетов. Поиск охватывает только .test.ts и .spec.ts; для тестов с другими именами или в .tsx шаблон придётся расширить.
Как поставить и вызвать
Команда установки ниже кладёт всю папку. Агент сам подхватывает скилл по описанию, когда речь заходит о shoehorn или приведениях в тестах. Вызвать вручную:
- Claude Code:
/migrate-to-shoehornили попросить скилл по имени. - Codex:
$migrate-to-shoehorn. - Cursor: наберите
/в чате Agent и выберитеmigrate-to-shoehorn.
Пример: /migrate-to-shoehorn Замени приведения as в src/api, поставь shoehorn как dev-зависимость и в конце запусти tsc.
Чем отличается от похожих
Такой миграции в нашем каталоге больше нет. Написание юнит-тестов пишет новые тесты к готовому коду и подменяет только внешние границы, но о типизации тестовых данных не говорит ничего. Упрощение кода убирает приведения, которые повторяют выведенный тип, — в любом коде и без замены. Этот скилл узкий: одна библиотека, один вид правки, только тестовые файлы.
Установка
Выполните одну команду — она сохранит SKILL.md и файлы, которые он использует, в папку скиллов агента. Claude Code и Codex подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.
Скилл написан на английском — агент поймёт его и ответит вам по-русски.
curl -fsSL --create-dirs -o ~/.claude/skills/migrate-to-shoehorn/SKILL.md https://anymodel.org/en/skills/matt-pocock/migrate-to-shoehorn/SKILL.md -o ~/.claude/skills/migrate-to-shoehorn/LICENSE https://anymodel.org/en/skills/matt-pocock/migrate-to-shoehorn/LICENSE -o ~/.claude/skills/migrate-to-shoehorn/agents/openai.yaml https://anymodel.org/en/skills/matt-pocock/migrate-to-shoehorn/agents/openai.yaml
curl -fsSL --create-dirs -o ~/.agents/skills/migrate-to-shoehorn/SKILL.md https://anymodel.org/en/skills/matt-pocock/migrate-to-shoehorn/SKILL.md -o ~/.agents/skills/migrate-to-shoehorn/LICENSE https://anymodel.org/en/skills/matt-pocock/migrate-to-shoehorn/LICENSE -o ~/.agents/skills/migrate-to-shoehorn/agents/openai.yaml https://anymodel.org/en/skills/matt-pocock/migrate-to-shoehorn/agents/openai.yaml
foreach ($f in 'SKILL.md','LICENSE','agents/openai.yaml') { $p = Join-Path "$HOME\.claude\skills\migrate-to-shoehorn" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/matt-pocock/migrate-to-shoehorn/$f" -UseBasicParsing -OutFile $p }foreach ($f in 'SKILL.md','LICENSE','agents/openai.yaml') { $p = Join-Path "$HOME\.agents\skills\migrate-to-shoehorn" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/matt-pocock/migrate-to-shoehorn/$f" -UseBasicParsing -OutFile $p }Другой агент: сохраните файл в его папку скиллов или дайте ему ссылку на файл: https://anymodel.org/en/skills/matt-pocock/migrate-to-shoehorn/SKILL.md
SKILL.md
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
npm i @total-typescript/shoehorn
Migration patterns
Large objects with few needed properties
Before:
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:
import { fromPartial } from "@total-typescript/shoehorn";
it("gets user by id", () => {
getUser(
fromPartial({
body: { id: "123" },
}),
);
});
as Type → fromPartial()
Before:
getUser({ body: { id: "123" } } as Request);
After:
import { fromPartial } from "@total-typescript/shoehorn";
getUser(fromPartial({ body: { id: "123" } }));
as unknown as Type → fromAny()
Before:
getUser({ body: { id: 123 } } as unknown as Request); // wrong type on purpose
After:
import { fromAny } from "@total-typescript/shoehorn";
getUser(fromAny({ body: { id: 123 } }));
When to use each
| Function | Use case |
|---|---|
fromPartial() |
Pass partial data that still type-checks |
fromAny() |
Pass intentionally wrong data (keeps autocomplete) |
fromExact() |
Force full object (swap with fromPartial later) |
Workflow
Gather requirements - ask user:
- What test files have
asassertions causing problems? - Are they dealing with large objects where only some properties matter?
- Do they need to pass intentionally wrong data for error testing?
- What test files have
Install and migrate:
- Install:
npm i @total-typescript/shoehorn - Find test files with
asassertions:grep -r " as [A-Z]" --include="*.test.ts" --include="*.spec.ts" - Replace
as TypewithfromPartial() - Replace
as unknown as TypewithfromAny() - Add imports from
@total-typescript/shoehorn - Run type check to verify
- Install:
Подключить через AnyModel API
Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.
AnyModel