script-refactorer

license	Apache-2.0
name	script-refactorer
description	Modernizes legacy scripts (bash, Node, Python) by replacing deprecated APIs, adding error handling, converting callbacks to async/await, and improving maintainability. Turns brittle one-off scripts into reliable, documented tools.
category	Code Quality & Testing
tags	["refactoring","scripts","modernization","cleanup","maintenance"]
allowed-tools	["Read","Bash(*)","Glob","Grep","Write","Edit"]
pairs-with	[{"skill":"refactoring-surgeon","reason":"General refactoring principles applied to scripts"},{"skill":"error-handling-patterns","reason":"Robust error handling is the primary script improvement"},{"skill":"beautiful-cli-design","reason":"Good CLI ergonomics for script interfaces"},{"skill":"devops-automator","reason":"Scripts often live inside CI/CD pipelines"}]

Script Refactorer

Modernizes legacy scripts into reliable, maintainable tools. Replaces deprecated patterns, adds error handling and input validation, converts callback spaghetti to async/await, and turns undocumented one-off hacks into proper CLI tools.

Activation Triggers

Use this skill when:

• A bash/Node/Python script works but is fragile, undocumented, or hard to modify
• Scripts use deprecated Node.js APIs (e.g., new Buffer(), url.parse(), fs.exists())
• Callback-heavy Node.js code needs async/await conversion
• Scripts lack error handling and fail silently or with cryptic messages
• A script needs proper CLI argument parsing, help text, and exit codes
• Legacy Python 2 patterns need updating to modern Python 3
• Shell scripts lack set -euo pipefail and proper quoting

Do NOT use this skill for:

• Rewriting scripts from scratch in a different language (use the appropriate language skill)
• Building new CLI tools (use beautiful-cli-design)
• Large application refactoring (use refactor-architect for planning, refactoring-surgeon for execution)
• Performance optimization of scripts (use performance-profiling)

Core Capabilities

1. Bash Script Modernization

Before -- the kind of script that makes you wince:

#!/bin/bash
# deploy.sh - "works on my machine"

cd /opt/app
git pull
npm install
npm run build
pm2 restart app
echo "done"

After -- a script you can trust:

#!/usr/bin/env bash
set -euo pipefail

# deploy.sh — Deploy application with rollback safety
# Usage: deploy.sh [--branch <branch>] [--skip-build] [--dry-run]

readonly SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
readonly APP_DIR=
 LOG_FILE=


BRANCH=
SKIP_BUILD=
DRY_RUN=

() {
   <<
   0
}

() {   |  -a ; }
() {   >&2;  1; }

() {
   [[  -gt 0 ]]; 
      
      --branch)   BRANCH=;  2 ;;
      --skip-build) SKIP_BUILD=;  ;;
      --dry-run)  DRY_RUN=;  ;;
      -h|--)  usage ;;
      *)          die  ;;
    
  
}

() {
   -v git >/dev/null 2>&1 || die 
   -v npm >/dev/null 2>&1 || die 
   -v pm2 >/dev/null 2>&1 || die 
  [[ -d  ]] || die 
}

() {
  parse_args 
  preflight_checks

   prev_commit
  prev_commit=$(git -C  rev-parse HEAD)
   
   

   ; 
     
     0
  

  
    ERR

  git -C  fetch origin 
  git -C  checkout 
  git -C  pull origin 

   ! ; 
     
    (  && npm ci --production)
     
    (  && npm run build)
  

   
  pm2 restart 

   
}

main