widen-return-type — скилл для Claude Code: что делает и как установить
Скилл widen-return-type для правок TypeScript: расширяет возвращаемый тип функции через перегрузки, не теряя узкие типы в местах вызова.
MIT ★ 539 обновлён 2026-10-29
npx skills add ZaxbyHub/opencode-swarm --skill widen-return-type -a claude-codeЧто делает widen-return-type
Скилл задаёт порядок правки, когда функции нужен более широкий возвращаемый тип ради расширяемости. Узкие типы при этом сохраняются перегрузками TypeScript: старый вызов продолжает видеть конкретный тип, новый получает общий. Приводить типы вручную не требуется.
Второе требование — повторять уже принятый в проекте паттерн opt-in, а не изобретать свой. Значит: отдельная константа с картой инструментов, условное слияние в agents/index.ts и тесты, которые проверяют и выключенное, и включённое состояние. Новый механизм гейтинга фича-флагов скилл прямо запрещает, так что правка с самодельной схемой ревью не пройдёт.
Ревьюер сверяет дифф: каждое обязательное действие должно быть в изменениях. При делегировании задачи в промпт подставляют строку SKILLS: file:.opencode/skills/generated/widen-return-type/SKILL.md, иначе субагент про этот порядок не узнаёт.
Какие задачи решает
- Расширить возвращаемый тип функции, не сломав узкие типы у вызывающего кода
- Заменить приведение типов аккуратными перегрузками TypeScript
- Провести новый инструмент через фича-флаг по уже принятой в проекте схеме
- Покрыть тестами выключенное и включённое состояние гейтинга
- Сверить дифф со списком обязательных шагов до мержа
Примеры запросов агенту
- Расширь возвращаемый тип
loadTools()через перегрузки, узкие типы у вызовов сохрани. - Заведи opt-in tool map отдельной константой и слей её в
agents/index.tsпод фича-флагом. - Добавь gating-тесты на выключенный и включённый режим и проверь, что в диффе есть все шаги.
Как установить widen-return-type
1Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill widen-return-type -a claude-code2Вручную: положить файлы
~/.claude/skills/widen-return-type/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/widen-return-type/
1Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill widen-return-type -a codex2Вручную: положить файлы
.agents/skills/widen-return-type/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill widen-return-type -a cursor2Вручную: положить файлы
.cursor/skills/widen-return-type/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ZaxbyHub/opencode-swarm .opencode/skills/generated/widen-return-type2Вручную: положить файлы
.github/skills/widen-return-type/SKILL.md1Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill widen-return-type -a gemini-cli2Командой платформы
gemini skills install https://github.com/ZaxbyHub/opencode-swarm --path .opencode/skills/generated/widen-return-typeВручную: положить файлы
.devin/skills/widen-return-type/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill widen-return-type -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о widen-return-type
Как установить widen-return-type в Claude Code?
Выполните npx skills add ZaxbyHub/opencode-swarm --skill widen-return-type -a claude-code. Файл скилла окажется в ~/.claude/skills/widen-return-type/SKILL.md.
Что делает widen-return-type?
Описывает, как расширять возвращаемый тип функции через перегрузки и как повторять существующий паттерн opt-in: отдельная карта инструментов, условное слияние в agents/index.ts, тесты на оба состояния флага.
Что нужно, чтобы скилл сработал при делегировании?
В промпт задачи добавляют строку SKILLS: file:.opencode/skills/generated/widen-return-type/SKILL.md. Ревьюер затем проверяет, что каждое обязательное действие видно в диффе.
Исходный текст
SKILL.md · MIT
--- name: widen-return-type description: widen return type metadata: triggers: '["widen return type","opt-in tool map","feature flag gating","tool registration"]' generated_from_knowledge: '[]' source_knowledge_ids: '[]' generated_at: "2026-07-02T02:11:00.606Z" confidence: "0.60" status: active version: "2" skill_origin: generated --- <!-- generated by opencode-swarm skill-generator. Do not edit by hand; edits will be preserved on regeneration only with controlled update mode. --> # widen return type ## Trigger - widen return type - opt-in tool map - feature flag gating - tool registration ## Required Procedure - use TypeScript overloads to preserve narrow return types when widening a function's return type for extensibility - mirror existing opt-in pattern: separate tool map constant, conditional merge in agents/index.ts, gating tests verifying disabled and enabled states ## Forbidden Shortcuts - invent new tool-gating mechanisms for opt-in feature flags ## Delegation Template When delegating a task affected by this skill, include: ``` SKILLS: file:.opencode/skills/generated/widen-return-type/SKILL.md ``` ## Reviewer Checks - Verify each required action above appears in the diff.</item>
© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm