rn-upgrade-pulse

RN Upgrade Pulse

Overview

This skill records a fixed set of upgrade inputs before an agent changes a React Native or Expo project: the manifests, lockfiles, app-level and native configuration, Node pins and CI files that references/commands.md names, and nothing else. It reports installed version evidence, package-manager and lockfile candidates, native ownership, configuration seams, and the verification commands the project already declares. It does not select a target version, arbitrate between competing sources, or apply an upgrade.

When to Use

• "what will this React Native upgrade touch?"
• "assess this Expo SDK upgrade before we start"
• "prepare an upgrade plan for this app or workspace"
• "find the risky native and dependency areas before a version bump"

Prerequisites

• An identified repository and app root.
• The app root inside a git worktree: native ownership evidence comes from git check-ignore and git ls-files, which fail outside one.
• rg (ripgrep) for the discovery commands that search by pattern, and Node.js 18.3.0 or later for the bundled helper, which uses node:util parseArgs.
• Access to the project manifests, lockfiles, native directories, and existing CI scripts.
• A redacted copy of every file whose contents a row prints. No such row reads an original: the user decides once per file what a copy contains, and a file with no copy is reported as an unread input rather than read anyway.
• The bundled helpers are the exception, because each reads a file itself and prints a bounded result rather than the file. The rows that take an original need no copy, and references/commands.md is where they are named; do not ask for one and do not skip those files for want of one.

Quick Steps

Each step names rows from references/commands.md by intent. That file holds every command body, so a glob set has one home.

1 — Set the selected paths

REPO_DIR=/absolute/path/to/repository
APP_DIR="$REPO_DIR/path/to/app"
SKILL_DIR=/absolute/path/to/this/skill