Our review
Quickly diagnoses and fixes issues in an existing project by auto-detecting the project type and running multiple checks.
Strengths
- Automatic detection of project type and framework
- Runs comprehensive diagnostics (environment, security, tests, dependencies, logs)
- Generates a targeted fix plan based on analysis
- Optional auto-run mode to immediately apply fixes
Limitations
- Requires the project to have a recognizable structure
- May not catch all domain-specific issues
- Automatic analysis can be intrusive if it modifies configurations
Use this skill when you need to quickly fix bugs or quality issues in an existing codebase without setting up a full PRD workflow.
Avoid using it for highly complex or niche projects where deep human analysis is better, or when you don't want automated changes to files.
Security analysis
CautionThe skill uses Bash for legitimate diagnostic and fix purposes, which is powerful but could be exploited if untrusted inputs are processed. No explicit destructive or exfiltration instructions, but caution is warranted.
- •Uses Bash tool which can execute arbitrary commands. The diagnostics (environment-doctor, security-auditor, etc.) may run potentially dangerous commands automatically.
Examples
Run ralph-fix on the Node.js project in ./my-project to diagnose and fix security vulnerabilities and other issues.Use ralph-fix with --analyze-only to diagnose issues in the current project without generating a fix plan.name: ralph-fix description: Quick-fix mode for existing projects. Auto-detects project type, runs diagnostics, and creates a targeted fix plan. Use when you need to fix bugs or issues in an existing codebase without full PRD setup. allowed-tools: Read, Write, Edit, Bash, Grep, Glob
Ralph Ultra Quick Fix
Rapidly diagnose and fix issues in an existing project.
What this does
- Auto-detects project type and framework
- Runs diagnostics — environment-doctor, security-auditor, flaky-test-detector
- Creates minimal
.ralph-ultra/setup if not present - Generates fix PRD — Targeted stories for identified issues
- Optionally runs the fix loop immediately
Usage
/ralph-ultra:ralph-fix [--dir path] [--analyze-only] [--auto-run]
Options
| Option | Default | Description |
|--------|---------|-------------|
| --dir | . | Project directory to fix |
| --analyze-only | false | Only analyze, don't create fix plan |
| --auto-run | false | Immediately run fix loop after analysis |
Diagnostics Run
- Environment Doctor — Runtime versions, missing deps, stale caches
- Security Auditor — Vulnerabilities, hardcoded secrets, insecure patterns
- Flaky Test Detector — Intermittent test failures
- Dependency Updater — Outdated packages, known CVEs
- Log Analyzer — Recent error patterns
Example
Fix a Node.js project with security issues:
/ralph-ultra:ralph-fix --dir ./my-project
Next.js App Router Expert
Development
A skill that turns Claude into a Next.js App Router expert.
README Generator
Development
Creates professional and comprehensive README.md files for your projects.
API Documentation Writer
Development
Generates comprehensive API documentation in OpenAPI/Swagger format.