tsdown — скилл
Два скилла для сборщика tsdown: настройка сборки TypeScript-библиотек и перенос проекта с tsup
- 4 334 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент ставит npm-пакеты и правит конфигурацию сборки
- Миграционная команда `npx tsdown-migrate` переписывает файлы проекта
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/tsdownОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент ставит npm-пакеты и правит конфигурацию сборки
- Миграционная команда `npx tsdown-migrate` переписывает файлы проекта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
tsdown — сборщик библиотек на Rolldown и Oxc, а в его репозитории лежат два скилла для агентов. Скилл `tsdown` рассказывает, как собирать пакеты для npm: несколько форматов вывода (ESM, CJS, IIFE, UMD), файлы деклараций `.d.ts`, минификация, внешние и встроенные зависимости, файл конфигурации и режим слежения. Отдельные справочные страницы разбирают плагины, хуки, программный API и опции Rolldown, а также сборку библиотек компонентов на React, Vue, Solid и Svelte. Скилл `tsdown-migrate` помогает перейти с tsup: у него есть таблицы соответствия опций и разбор отличий, а команда `npx tsdown-migrate` переписывает конфигурацию. В запросе агенту хватает фразы вроде «настрой tsdown для моей библиотеки» или «перенеси сборку с tsup».
Для кого. Авторам библиотек на TypeScript, которые собирают пакеты для npm или переходят с tsup и работают в Claude Code, Cursor или Codex.
Подходит, если
- Библиотеку нужно выпустить сразу в ESM и CJS с файлами деклараций
- Проект на tsup переносится на tsdown с минимальными правками конфигурации
- Монорепозиторий собирает несколько пакетов через рабочие пространства tsdown
- Библиотека компонентов на React или Vue требует отдельной настройки сборки
- Сборка должна поддерживать Node.js 18 и 20, хотя сам tsdown запускается на новее
Не подходит, если
- Нужно собрать веб-приложение, а не библиотеку: для этого подойдет сборщик приложений вроде Vite
- Проект не на TypeScript или JavaScript: сборщик рассчитан на эти языки
- Вы дорабатываете сам репозиторий tsdown: скиллы описывают использование, а не разработку сборщика
Пример запроса к агенту
Настрой tsdown для моей библиотеки: форматы ESM и CJS, файлы деклараций и очистка папки `dist` перед сборкойОграничения
Сам tsdown запускается на Node.js 22.18.0 или новее, хотя собранный результат можно нацелить на Node.js 18 и 20 опцией `target`. Совместимость с tsup заявлена для основных опций, остальные параметры придется сверять вручную по таблицам скилла миграции. Команда `npx skills add rolldown/tsdown` ставит оба скилла сразу, а для одного основного скилла добавляют флаг `--skill tsdown`. Скилл опирается на документацию с сайта tsdown.dev и справку внутри репозитория, поэтому для новых опций его стоит обновлять вместе с версией сборщика.
Как отключить. Удалите папки `tsdown` и `tsdown-migrate` из каталога скиллов проекта. Пакет `tsdown` в `devDependencies` удаляется командой вашего менеджера пакетов.
Частые вопросы
Как поставить скиллы tsdown?
Выполните `npx skills add rolldown/tsdown`: команда ставит оба скилла, включая миграционный. Чтобы взять только основной, добавьте `--skill tsdown`.
Как перейти с tsup на tsdown?
Запустите `npx tsdown-migrate`, затем сверьте опции по таблицам соответствия из скилла `tsdown-migrate`. Сам tsdown совместим с основными опциями tsup, поэтому правок в конфигурации обычно немного.
Какая версия Node.js нужна для tsdown?
Для запуска сборки нужен Node.js 22.18.0 или новее. Выпускаемый пакет можно нацелить ниже опцией `target`, например `node18` или `node20`, и проверить на этих версиях в CI.
Какие форматы вывода поддерживает tsdown?
ESM, CJS, IIFE и UMD, плюс файлы деклараций `.d.ts`. Формат задают в `format` файла `tsdown.config.ts`, а декларации включает опция `dts: true`.
Подходит ли tsdown для библиотек компонентов?
Да, в скилле есть отдельные справочные страницы для React, Vue, Solid и Svelte. Они описывают поддержку фреймворков, включая Fast Refresh для React.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл для агентов с конвенциями TypeScript: типы, дискриминированные объединения, функции, именование, структура, React и тесты, подгружается по темам
CLI запускает TypeScript в Node.js без отдельной сборки, чтобы агент проверял служебные сценарии и локальные утилиты.
dotnet-skills — установщик скиллов для .NET
dotnet-skills
Установщик каталога скиллов для .NET: сам подбирает их по файлам проекта и ставит в Claude Code, Codex, Copilot и Gemini CLI
es-toolkit для агентов: помощь с установкой и импортами, перенос кода с lodash и выбор между strict и compat
Oxc — скиллы миграции на Oxlint и Oxfmt
Oxc migration skills
Два официальных скилла Oxc: агент переводит проект с ESLint на линтер Oxlint и с Prettier или Biome на форматтер Oxfmt
skills-npm подключает скиллы агентов из зависимостей проекта в node_modules и из поля skills в package.json
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| tsdown (эта карточка) | да | 4 334 | |
| Webpack Bundle Analyzer CLI | нет | 12 652 | разбирает размер уже собранных бандлов и сборку не настраивает |
| Nx CLI | нет | 29 454 | управляет монорепозиторием целиком, а не сборкой одной библиотеки |
Коротко о README
README самого сборщика короткий: список преимуществ, ссылка на документацию, установка командой `npm i -D tsdown` и запуск через `npx tsdown`. О скиллах рассказывает `skills/tsdown/README.md`: установка, состав, сценарии применения и примеры запросов.
Бейдж для README
Исходный SKILL.md
--- name: tsdown description: Bundle TypeScript and JavaScript libraries with blazing-fast speed powered by Rolldown. Use when building libraries, generating type declarations, bundling for multiple formats, or migrating from tsup. --- # tsdown - The Elegant Library Bundler Blazing-fast bundler for TypeScript/JavaScript libraries powered by Rolldown and Oxc. ## Runtime Requirement `tsdown` requires **Node.js 22.18.0 or higher to run** (build-time only). However, the bundled output can target much lower Node.js versions via the [`target`](references/option-target.md) option, so libraries built with tsdown are **not locked to Node.js 22+ at runtime**. If your package needs to support Node.js 18 / 20: - **Build with Node.js 22+ in CI** (e.g. set `target: 'node18'` or `target: 'node20'`). - **Test the built output (or the packed tarball) on the lower Node.js versions** you intend to support — e.g. using a matrix job that runs the published package's tests on Node.js 18 / 20 / 22. ## When to Use - Building TypeScript/JavaScript libraries for npm - Generating TypeScript declaration files (.d.ts) - Bundling for multiple formats (ESM, CJS, IIFE, UMD) - Optimizing bundles with tree shaking and minification - Migrating from tsup with minimal changes - Building React, Vue, Solid, or Svelte component libraries ## Quick Start ```bash # Install pnpm add -D tsdown # Basic usage npx tsdown # With config file npx tsdown --config tsdown.config.ts # Watch mode npx tsdown --watch # Migrate from tsup npx tsdown-migrate ```