sync-upstream

Sync upstream repository changes into a Goofish TanStack Start project.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/wztlink1013/goofish-tanstack --skill sync-upstream-wztlink1013
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-upstream
Source: https://github.com/wztlink1013/goofish-tanstack/tree/main/.claude/skills/sync-upstream
Command: npx skills add https://github.com/wztlink1013/goofish-tanstack --skill sync-upstream-wztlink1013

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill ensures your Goofish TanStack Start project stays current by automatically synchronizing the latest template changes from the upstream 'shipany-next' repository.

Core Features & Use Cases

  • Upstream Sync: Pulls in the latest changes from the 'shipany-next' repository, including framework updates.
  • Framework Adaptation: Adapts code to replace Next.js with TanStack Start, next-intl with paraglide, and adjusts router logic.
  • Re-Implementation: Converts pages and API routes from Next.js to TanStack Start's routing system.
  • Skip and Port: Decides which parts of the code to skip (like Next.js-specific middleware) and which to port directly.

Quick Start

To update your project with the latest upstream features, run: sync-upstream -u <upstream-repo-url> -b <branch>

Frequently Asked Questions about sync-upstream

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync upstream changes from a Next.js repo to a TanStack Start project?

To sync upstream changes, this Skill pulls the latest code from a specified repository and automatically adapts Next.js pages and API routes to TanStack Start's routing system. It handles framework conversions like replacing next-intl with paraglide.

What is the best way to port Next.js middleware to TanStack Start?

Porting Next.js middleware to TanStack Start requires manual re-implementation. The Skill identifies Next.js-specific middleware and skips it during the automated sync, leaving the router logic adaptation to the developer.

Can I automatically convert Next.js API routes to TanStack Start routing?

Yes, you can automatically convert Next.js API routes. The Skill re-implements pages and API routes by mapping them to TanStack Start's routing system while adjusting the underlying router logic for the local project structure.

Does syncing an upstream repository require a specific local project configuration?

Yes, syncing an upstream repository depends heavily on your local project structure and configuration. The Skill requires an existing Goofish TanStack Start project to correctly port and adapt the upstream template changes.

How to handle Next.js-specific features when porting code to TanStack Start?

Handling Next.js-specific features during porting involves a skip and port mechanism. The Skill automatically skips incompatible features like Next.js middleware and requires manual re-implementations for other Next.js-specific functionalities.