К основному содержанию
скилл CX Codex

tanstack-cli · oakoss — скилл для Claude Code: что делает и как установить

Скилл tanstack-cli настраивает сборку библиотек через TanStack Config и Vite с генерацией типов и релизом через conventional commits.

MIT 115 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill tanstack-cli -a claude-code
Открыть на GitHub

Что делает tanstack-cli

Скилл содержит правила сборки библиотек по стандартам экосистемы TanStack. Он помогает сконфигурировать плагин @tanstack/vite-config, подготовить двойной вывод в ESM и CJS, а также настроить автоматическую генерацию файлов деклараций .d.ts и .d.cts. Для релизов используется @tanstack/publish-config, где версии и каналы (alpha, beta, main) рассчитываются по conventional commits.

Инструмент ориентирован строго на библиотеки и не подходит для сборки приложений. Единственный поддерживаемый пакетный менеджер — pnpm (версии 8 и выше), с npm или yarn пайплайн работать не рассчитан. Для работы также требуются Node.js от 18.17, установленные Git CLI и Vite в роли peer-зависимости, а для проверки пакета перед публикацией применяется publint --strict.

Какие задачи решает

  • настроить dual ESM/CJS сборку библиотеки через Vite
  • прописать правила экспорта types и conditional exports в package.json
  • автоматизировать публикацию пакетов по conventional commits
  • исключить тестовые файлы из генерации типов деклараций

Примеры запросов агенту

  • Настрой сборку библиотеки через @tanstack/vite-config с точкой входа src/index.ts
  • Проверь package.json и vite.config.ts на соответствие конвенциям TanStack
  • Настрой скрипт публикации через @tanstack/publish-config для веток main и beta

Как установить tanstack-cli

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill tanstack-cli -a claude-code

2Вручную: положить файлы

~/.claude/skills/tanstack-cli/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/tanstack-cli/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о tanstack-cli

Как установить tanstack-cli в Claude Code?

Выполните команду npx skills add oakoss/agent-skills --skill tanstack-cli -a claude-code. Файл навыка сохранится в ~/.claude/skills/tanstack-cli/SKILL.md.

Что делает скилл tanstack-cli?

Он инструктирует агента по созданию конфигов сборки библиотек через @tanstack/vite-config и автоматизации версионирования через @tanstack/publish-config.

Можно ли использовать скилл в проектах на npm или yarn?

Нет, конфигурация TanStack рассчитана строго на менеджер пакетов pnpm версии 8 и выше.

Исходный текст

SKILL.md · MIT
---
name: tanstack-cli
description: >
  TanStack Config for shared build tooling, Vite plugins, and package configuration across TanStack projects.
  Use when configuring TanStack library builds or contributing to TanStack packages.
  Use for tanstack-config, tanstack-cli, vite-plugin, package-config, library-build.
license: MIT
metadata:
  author: oakoss
  version: '1.0'
  source: 'https://tanstack.com/config/latest'
user-invocable: false
---

# TanStack Config

## Overview

TanStack Config provides opinionated tooling to build, version, and publish JavaScript/TypeScript packages with minimal configuration and consistent results. It uses Vite for library builds with automatic dual ESM/CJS output and type generation, plus automated publishing with conventional-commit-based versioning.

**When to use:** Building TanStack libraries or packages that follow TanStack conventions, contributing to TanStack open-source projects, setting up dual ESM/CJS library builds with Vite, automating package publishing with conventional commits.

**When NOT to use:** Application builds (use framework-specific tooling), non-library projects, projects not using pnpm, projects that need non-Vite build pipelines.

## Quick Reference

| Pattern            | API / Package                                       | Key Points                                              |
| ------------------ | --------------------------------------------------- | ------------------------------------------------------- |
| Vite build config  | `tanstackViteConfig()` from `@tanstack/vite-config` | Merge with `defineConfig` via `mergeConfig`             |
| Entry point        | `entry: './src/index.ts'`                           | Single file or array of entry files                     |
| Source directory   | `srcDir: './src'`                                   | Used for declaration file generation                    |
| CJS output         | `cjs: true` (default)                               | Generates `.cjs` and `.d.cts` alongside ESM             |
| External deps      | `externalDeps: [/^@internal\//]`                    | Auto-detected from `package.json`, extend with patterns |
| Bundled deps       | `bundledDeps: ['tiny-invariant']`                   | Bundle instead of externalize                           |
| Exclude from types | `exclude: ['./src/**/*.test.ts']`                   | Patterns to skip during type generation                 |
| Custom tsconfig    | `tsconfigPath: './tsconfig.build.json'`             | Override default tsconfig for builds                    |
| Declaration hook   | `beforeWriteDeclarationFile(path, content)`         | Transform `.d.ts` content before write                  |
| Publish automation | `publish()` from `@tanstack/publish-config`         | Conventional commits drive versioning                   |
| Branch configs     | `branchConfigs: { main, beta, alpha }`              | Control prerelease and stable channels                  |
| Package list       | `packages: [{ name, packageDir }]`                  | Monorepo package definitions                            |
| Build script       | `vite build && publint --strict`                    | Standard build with strict linting                      |

## Common Mistakes

| Mistake                                          | Correct Pattern                                                            |
| ------------------------------------------------ | -------------------------------------------------------------------------- |
| Missing `"type": "module"` in `package.json`     | Set `"type": "module"` for ESM-first builds                                |
| Using `defineConfig` alone without `mergeConfig` | Use `mergeConfig(defineConfig({...}), tanstackViteConfig({...}))`          |
| Forgetting `entry` or `srcDir` options           | Both are required for `tanstackViteConfig` to work                         |
| Missing `exports` field in `package.json`        | Define `import` and `require` conditions with types                        |
| Not awaiting `publish()` promise                 | Handle with `.then()` and `.catch()` for error reporting                   |
| Using npm or yarn instead of pnpm                | pnpm is the only supported package manager                                 |
| Omitting `publint --strict` from build script    | Add `publint --strict` after `vite build` to catch packaging issues        |
| Setting `tag` without `v` prefix                 | Manual version tags must start with `v` (e.g., `v1.0.0`)                   |
| Wrong commit type for release level              | `fix`/`refactor`/`perf` = patch, `feat` = minor, `BREAKING CHANGE` = major |

## Requirements

- Node.js v18.17+
- pnpm v8+
- Git CLI
- GitHub CLI (pre-installed on GitHub Actions)
- Vite (peer dependency for build config)
- publint (recommended for build validation)

## Delegation

- **Build configuration review**: Use `Task` agent to verify Vite config and `package.json` exports
- **Publishing workflow setup**: Use `Explore` agent to check CI/CD integration patterns
- **Package validation**: Run `publint --strict` after builds to catch packaging issues

## References

- [Configuration and Vite plugin setup](references/configuration.md)
- [Publishing and version management](references/publishing.md)

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →

Сначала — tanstack-cli от других авторов.

tanstack-cli tanstack-skills Скилл tanstack-cli проводит агента через создание проекта TanStack Start: подбирает интеграции, генерирует структуру и подсказывает по деплою. CX Codex +1 1 700установок clerk-tanstack-patterns clerk Скилл clerk-tanstack-patterns для Claude Code подсказывает, как настроить авторизацию Clerk в TanStack React Start. Активируется при работе с createServerFn, защитой маршрутов через beforeLoad и middleware. CX Codex +1 16 400установок tanstack-vue-router-skilld skilld-dev Скилл tanstack-vue-router-skilld для работы с @tanstack/vue-router — типобезопасным роутером Vue. Учит агента правилам настройки, file-based маршрутов, композаблов с Ref, линков и лоадеров. CX Codex +1 101установок tanstack-config tanstack-skills Скилл tanstack-config помогает настроить сборку, версионирование и публикацию пакетов JavaScript и TypeScript по стандартам TanStack. Пригодится при настройке монорепозитория на pnpm и Nx. CX Codex +1 1 500установок tanstack-start tanstack-skills Скилл помогает создавать и сопровождать приложения на фреймворке TanStack Start с потоковым SSR, серверными функциями и маршрутизацией. CX Codex +1 4 000установок tanstack-integration-best-practices DeckardGer Скилл tanstack-integration-best-practices для Claude Code задаёт правила стыковки TanStack Query, Router и Start. Описывает потоки данных, SSR с гидратацией и согласование кэша. CX Codex +1 3 100установок tanstack-ai-migration TanStack Скилл tanstack-ai-migration для Claude Code переносит проект на TanStack AI с Vercel AI SDK или обновляет версию 0.x до 1.0. Запускается при смене библиотек ИИ или обновлении пакетов. CX Codex +1 505установок

Из того же набора106

Весь набор →
svelte Справочник по Svelte 5 и SvelteKit для ИИ-агента: руны, сниппеты, роутинг, form actions и таблица перевода кода с Svelte 4. CX Codex +1 117установок react-native Помогает проектировать мобильные приложения на React Native и Expo с файловой маршрутизацией, EAS Build и нативными API под iOS и Android. CX Codex +1 117установок tiptap Скилл помогает собирать React-редакторы на Tiptap: настраивать расширения, SSR, загрузку изображений и совместное редактирование. Пригодится при добавлении редактора в приложение. CX Codex +1 117установок agent-patterns Скилл agent-patterns для Claude Code описывает паттерны мультиагентных систем и субагентов для организации задач в изолированных контекстах. CX Codex +1 115установок better-auth Подгружает агенту справочник по better-auth: конфиг, плагины, стратегии сессий и типовые ошибки. Даёт справку при настройке входа, 2FA и организаций. CX Codex +1 114установок meta-skill-creator Скилл meta-skill-creator помогает создавать и проверять агентские скиллы по открытому стандарту Agent Skills. Он пригодится при подготовке SKILL.md, структуры папок и файлов для распространения. CX Codex +1 114установок figma-developer Скилл figma-developer для Claude Code получает из Figma цвета, шрифты и иконки через REST API и собирает CSS-переменные и React-компоненты. Автоматизирует перенос изменений макета в код. CX Codex +1 114установок tanstack-store Объясняет агенту устройство TanStack Store: стор, производные значения, батчи и эффекты. Описывает общее состояние нескольких компонентов. CX Codex +1 113установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой