SkillsAdd

oakoss/agent-skills

tanstack-cli

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.

First seen Feb 20, 2026

Installation

$ npx skills add oakoss/agent-skills --skill tanstack-cli
View on skills.sh ↗ GitHub repository ↗

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

find-skills Same topic
vercel-labs/skills

Helps users discover and install agent skills when they ask questions like "how do I do X", "fi…

3.3M installs
agent-browser Same topic
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
vercel-react-best-practices Same topic
vercel-labs/agent-skills 697.8K installs
web-design-guidelines Same topic
vercel-labs/agent-skills

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…

617.3K installs
microsoft-foundry Same topic
microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

576.5K installs
azure-prepare Same topic
microsoft/azure-skills

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Te…

568.3K installs

Also in this package

Other skills from oakoss/agent-skills · top by installs.

npx skills add oakoss/agent-skills
ui-ux-polish 488 playwright 416 coolify 306 application-security 234 find-skills 210 brand-designer 195 knowledge-graph-builder 188 vitest-testing 183 content-humanizer 177 drizzle-orm 168

Browse all from oakoss/agent-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Also listed on

Alternate registries and mirrors of this skill.

Repository health

Stars 15
License MIT
Default branch main
Open issues 1
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version1.0
LicenseMIT
More metadata
author
oakoss
version
1.0
source
https://tanstack.com/config/latest

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 5,339 B
  • docs SUMMARY.md 293 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 87 installs

SKILL.md

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)