tanstack-cli · oakoss — скилл для Claude Code: что делает и как установить
Скилл tanstack-cli настраивает сборку библиотек через TanStack Config и Vite с генерацией типов и релизом через conventional commits.
MIT 115 установок ★ 29 обновлён 2026-08-17
npx skills add oakoss/agent-skills --skill tanstack-cli -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/tanstack-cli/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/tanstack-cli/
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tanstack-cli -a codex2Вручную: положить файлы
.agents/skills/tanstack-cli/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tanstack-cli -a cursor2Вручную: положить файлы
.cursor/skills/tanstack-cli/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install oakoss/agent-skills skills/tanstack-cli2Вручную: положить файлы
.github/skills/tanstack-cli/SKILL.md1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tanstack-cli -a gemini-cli2Командой платформы
gemini skills install https://github.com/oakoss/agent-skills --path skills/tanstack-cliВручную: положить файлы
.devin/skills/tanstack-cli/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill tanstack-cli -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.