packages/cli/skills/choose-ecosystem-integrations/SKILL.md
Map tanstack ecosystem partner metadata to installable add-on ids using tanstack ecosystem --json, tanstack create --list-add-ons --json, and tanstack create --addon-details --json. Covers exclusive categories, provider options, and router-only compatibility constraints.
npx skillsauth add tanstack/cli choose-ecosystem-integrationsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
This skill requires familiarity with scaffold and discovery workflows. Read create-app-scaffold and query-docs-library-metadata first.
Use this skill at the seam between user requirements and valid CLI integration choices.
npx @tanstack/cli ecosystem --json
npx @tanstack/cli create --list-add-ons --json
npx @tanstack/cli ecosystem --category database --json
npx @tanstack/cli create --list-add-ons --json
npx @tanstack/cli create --addon-details drizzle --json
npx @tanstack/cli create --addon-details prisma --json
npx @tanstack/cli create my-app \
--framework react \
--add-ons clerk,drizzle \
--deployment cloudflare \
-y
Wrong:
npx @tanstack/cli add <partner-id-from-ecosystem>
Correct:
npx @tanstack/cli ecosystem --json
npx @tanstack/cli create --list-add-ons --json
npx @tanstack/cli add <mapped-addon-id>
ecosystem includes partners that are not directly installable add-ons, so direct reuse of partner ids can fail late in add/apply flows.
Source: tanstack ecosystem --json output + tanstack create --list-add-ons --json output
Wrong:
npx @tanstack/cli create my-app --add-ons prisma -y
Correct:
npx @tanstack/cli create --addon-details prisma --json
npx @tanstack/cli create my-app --add-ons prisma -y
Optionized providers can default silently, producing the wrong data-layer stack for the requested integration.
Source: tanstack create --addon-details prisma --json
Wrong:
npx @tanstack/cli create my-app --add-ons clerk,workos -y
Correct:
npx @tanstack/cli create my-app --add-ons clerk -y
Exclusive categories permit only one active choice, so multi-select commands can drop or replace intended providers.
Source: packages/create/src/frameworks///info.json
Wrong:
npx @tanstack/cli create my-app --router-only --deployment cloudflare -y
Correct:
npx @tanstack/cli create my-app --router-only -y
Router-only mode ignores deployment integration, so the command succeeds without applying the intended ecosystem target.
Source: packages/cli/src/command-line.ts:349
This domain's patterns conflict with create-app-scaffold. Integration planning tends to over-assume command intent is preserved, but compatibility mode silently strips integration flags.
See also: create-app-scaffold/SKILL.md § Common Mistakes
This domain's patterns conflict with query-docs-library-metadata. Integration choices tend to drift when discovery metadata is skipped in favor of one-shot scaffold commands.
See also: query-docs-library-metadata/SKILL.md § Common Mistakes
development
Retrieve machine-readable context with tanstack libraries, tanstack doc, tanstack search-docs, tanstack create --list-add-ons --json, and --addon-details for agent-safe discovery and preflight validation.
development
Build and iterate custom add-ons/templates with tanstack add-on init, add-on compile, add-on dev, and tanstack create --dev-watch, including sync loop preconditions, watch-path validation, and project metadata constraints.
tools
Scaffold a TanStack app with tanstack create using --framework, --template, --toolchain, --deployment, --add-ons, and --router-only. Covers flag compatibility, non-interactive defaults, and intent-preserving command construction.
data-ai
Apply integrations to existing projects with tanstack add, including add-on id resolution, dependency chains, option prompts, and .cta.json project metadata preconditions.