refactor-shell

Analyze production Bash scripts for security risks and generate a prioritized refactor plan.

1|Updated Aug 16, 2025
One-click install
npx skills add https://github.com/RB-chrismandich/Manifest --skill refactor-shell-rb-chrismandich
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refactor-shell
Source: https://github.com/RB-chrismandich/Manifest/tree/main/configs/claude/skills/refactor-shell
Command: npx skills add https://github.com/RB-chrismandich/Manifest --skill refactor-shell-rb-chrismandich

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyze production Bash/Shell scripts to identify security risks and maintainability issues, and produce an actionable, prioritized refactor plan with guidance on risk and effort.

Core Features & Use Cases

  • ShellCheck-driven security and quality analysis for Bash scripts
  • Prioritized refactor roadmap with actionable recommendations
  • Consensus scoring to guide auto-refactor vs human review

Quick Start

Run the analysis to generate a prioritized refactor plan for the Bash scripts in the repository.

Frequently Asked Questions about refactor-shell

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

FAQPage Schema
How do I identify security vulnerabilities in Bash scripts?

To identify security vulnerabilities in Bash scripts, you need an analysis tool that detects common antipatterns and ShellCheck codes. This Skill analyzes your production scripts to pinpoint security risks and generate a prioritized refactor plan with risk and effort guidance.

How do I create a refactor plan for legacy Shell scripts?

Creating a refactor plan for legacy Shell scripts involves analyzing maintainability issues and security flaws. This Skill evaluates your Bash scripts against best practices to produce an actionable improvement roadmap, using consensus scoring to guide auto-refactor versus human review decisions.

Does this Bash refactoring tool require ShellCheck to run?

Yes, this Bash refactoring tool requires ShellCheck to run its security and quality analysis. ShellCheck provides the foundational code analysis that identifies vulnerabilities and antipatterns, which is then used to build the prioritized improvement roadmap for your CI/CD pipelines.

What is the best way to prioritize Bash script refactoring in CI/CD pipelines?

The best way to prioritize Bash script refactoring in CI/CD pipelines is to use a scoring framework that weighs risk and effort. This Skill analyzes your scripts and generates a prioritized refactor roadmap, helping you decide which issues to auto-refactor and which require human review.

Can I use this to analyze production Bash scripts for maintainability issues?

Yes, you can use this to analyze production Bash scripts for maintainability issues. It evaluates your scripts against Bash best practices and ShellCheck codes to detect antipatterns, producing a structured validation workflow and actionable improvement roadmap.

When should I not use an automated Bash refactoring approach?

You should not use an automated Bash refactoring approach when the consensus scoring indicates high risk or complex structural changes are needed. This Skill distinguishes between safe auto-refactors and areas requiring human review, ensuring critical security vulnerabilities are handled manually.