syncing-upstream

Update the Node.js submodule to the latest stable tag and regenerate patches.

3|1|Updated Nov 8, 2025
One-click install
npx skills add https://github.com/SocketDev/socket-btm --skill syncing-upstream
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: syncing-upstream
Source: https://github.com/SocketDev/socket-btm/tree/main/.claude/skills/syncing-upstream
Command: npx skills add https://github.com/SocketDev/socket-btm --skill syncing-upstream

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill keeps socket-btm's Node.js baseline aligned with the official upstream by updating the upstream submodule to the latest stable tag, ensuring tooling metadata and patches stay synchronized.

Core Features & Use Cases

  • Update the upstream Node.js submodule to the newest stable release.
  • Update the .node-version to match the new upstream version.
  • Regenerate all Socket Security patches for the new Node.js version and validate patch applicability.
  • Run full build and test validation to ensure patch success and stability.

Quick Start

Use the syncing-upstream skill to start an end-to-end synchronization: fetch the latest stable tag, update the submodule, bump the Node.js version, regenerate patches, validate the build and tests, and commit two atomic changes with detailed messages.

Frequently Asked Questions about syncing-upstream

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

FAQPage Schema
How do I sync a Node.js submodule with the latest stable upstream release?

To sync a Node.js submodule with the latest stable upstream release, update the submodule reference, bump the .node-version file, and regenerate existing patches to ensure full applicability and version compatibility.

What is the process for regenerating patches after a Node.js version update?

Regenerating patches after a Node.js version update involves updating the upstream submodule to a new stable tag, applying all existing Socket Security patches, and validating the build and tests to ensure patch success and stability.

Do I need a clean working directory before updating an upstream Node.js submodule?

Yes, a clean working directory is required before updating an upstream Node.js submodule to prevent conflicts during patch regeneration, build validation, and the creation of atomic commits with conventional messages.

How do I validate build and test stability after applying Node.js patches?

You validate build and test stability after applying Node.js patches by running full build validation and test suites, ensuring all patches apply successfully before committing two atomic changes with detailed metrics.

Can I use unstable tags when synchronizing the upstream Node.js baseline?

No, you cannot use unstable tags when synchronizing the upstream Node.js baseline; the workflow strictly requires using only stable tags to fetch the latest updates and ensure baseline stability.