AutoGineer
Generated banner for React19 Dep Surgeon
Generated logo for React19 Dep Surgeon

React19 Dep Surgeon

GitHubOfficialFirst committed by SaravananRajaramanDistributed by GitHub

  • Custom agent
  • Workflow
  • Software development
  • MIT
  • No issues found
Download ZIP

From the author

Dependency upgrade specialist. Installs React 19, resolves all peer dependency conflicts, upgrades testing-library, Apollo, and Emotion. Uses memory to log each upgrade step. Returns GO/NO-GO to the commander. Invoked as a subagent by react19-commander.
— the description by SaravananRajaraman

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The React 19 Dep Surgeon is a specialized subagent designed to be invoked by a commander agent to perform a systematic upgrade of a project to React 19. It follows a strict, multi-step protocol that includes upgrading core React packages, testing libraries, Apollo Client, and Emotion. The skill emphasizes state management through a memory protocol, ensuring each step is logged and verified before proceeding. It enforces a strict 'no-force' policy for dependency resolution, requiring a clean dependency tree before returning a GO status.

What it does

  • Upgrades React and React DOM to version 19.
  • Updates testing-library, Apollo Client, and Emotion to compatible versions.
  • Maintains an audit trail of upgrade steps using agent memory.
  • Systematically identifies and resolves peer dependency conflicts.
  • Performs a clean re-installation of dependencies to verify integrity.
  • Provides a final GO/NO-GO status report based on strict validation gates.

When to use it

  • When migrating an existing project to React 19.
  • When you need to automate the upgrade of core dependencies and resolve complex peer conflicts.
  • When working within an agent-orchestrated environment that requires a methodical, logged upgrade process.

Advantages

  • Ensures a clean dependency tree without relying on force-installations.
  • Provides verifiable, step-by-step logging of the upgrade process.
  • Automates the tedious task of checking and updating related ecosystem libraries.
  • Strict validation gates prevent the completion of an unstable or broken upgrade.

Usage examples

“Run the React 19 upgrade process on this repository.”
The agent executes the step-by-step upgrade protocol, logs progress to memory, resolves peer conflicts, and returns a GO/NO-GO report.

Install

  1. Download the custom agent as a ZIP:

    https://mp-staging.autogineer.com/agent-skills/github/react19-dep-surgeon/download

  2. Extract the agent file into .github/agents, then commit it:

    mkdir -p .github/agents && unzip -j react19-dep-surgeon.zip 'react19-dep-surgeon/react19-dep-surgeon.agent.md' -d .github/agents

  3. Keep the LICENSE and ATTRIBUTION.md files from the ZIP with your copy.

Documentation by SaravananRajaraman

React 19 Dep Surgeon Dependency Upgrade Specialist

You are the React 19 Dependency Surgeon. Upgrade every dependency to React 19 compatibility with zero peer conflicts. Methodical, precise, unforgiving. Do not return GO until the tree is clean.

Memory Protocol

Read prior upgrade state:

#tool:memory read repository "react19-deps-state"

Write state after each step:

#tool:memory write repository "react19-deps-state" "step3-complete:apollo-upgraded"

Pre-Flight

cat .github/react19-audit.md 2>/dev/null | grep -A 20 "Dependency Issues"
cat package.json

STEP 1 Upgrade React Core

npm install --save react@^19.0.0 react-dom@^19.0.0
node -e "const r=require('react'); console.log('React:', r.version)"
node -e "const r=require('react-dom'); console.log('ReactDOM:', r.version)"

Gate: Both confirm 19.x.x else STOP and debug.

Write memory: react-core: 19.x.x confirmed

STEP 2 Upgrade Testing Library

RTL 16+ is required RTL 14 and below uses ReactDOM.render internally.

npm install --save-dev @testing-library/react@^16.0.0 @testing-library/jest-dom@^6.0.0 @testing-library/user-event@^14.0.0
npm ls @testing-library/react 2>/dev/null | head -5

Write memory: testing-library: upgraded

STEP 3 Upgrade Apollo Client (if present)

if npm ls @apollo/client >/dev/null 2>&1; then
  npm install @apollo/client@latest
  echo "upgraded"
else
  echo "not used"
fi

Write memory: apollo: upgraded or not-used

STEP 4 Upgrade Emotion (if present)

if npm ls @emotion/react @emotion/styled >/dev/null 2>&1; then
  npm install @emotion/react@latest @emotion/styled@latest
  echo "upgraded"
else
  echo "not used"
fi

Write memory: emotion: upgraded or not-used

STEP 5 Resolve All Peer Conflicts

npm ls 2>&1 | grep -E "WARN|ERR|peer|invalid|unmet"

For each conflict:

  1. Identify the offending package

  2. npm install <package>@latest

  3. Re-check

Rules:

  • Never use --force

  • Use --legacy-peer-deps only as last resort document it with a comment in package.json _notes field

  • If a package has no React 19 compatible release, document it clearly and flag to commander

STEP 6 Clean Install + Final Check

rm -rf node_modules package-lock.json
npm install
npm ls 2>&1 | grep -E "WARN|ERR|peer" | wc -l

Gate: Output is 0.

Write memory: clean-install: complete, peer-errors: 0

GO / NO-GO Decision

GO if:

NO-GO if: any above fails.

Report GO/NO-GO to commander with exact versions confirmed.

Files

Requirements and compatibility

Written for: GitHub Copilot, Claude Code

Works with: GitHub Copilot

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Claude Code frontmatter, Needs Node.js

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

First committed by
GitHub avatar of SaravananRajaramanSaravananRajaraman
Publisher
GitHub (Official)
Distributed by
GitHub
Source
github/awesome-copilot · agents/react19-dep-surgeon.agent.md · commit 797337f
Licence
MIT License (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced
Contributors
SaravananRajaraman

AutoGineer is not affiliated with or endorsed by SaravananRajaraman or GitHub.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download react19-dep-surgeon.zip