laravel-raptor-cleanup

Audit and fix Laravel Raptor Vue/TS projects with approved changes.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/callcocam/raptor-skils --skill laravel-raptor-cleanup
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: laravel-raptor-cleanup
Source: https://github.com/callcocam/raptor-skils/tree/main/laravel-raptor-cleanup
Command: npx skills add https://github.com/callcocam/raptor-skils --skill laravel-raptor-cleanup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps maintain code quality in Laravel Raptor Vue/TS projects by identifying and correcting naming inconsistencies (PT-BR/English), pruning obsolete files not imported anywhere, detecting duplicate or similar components sharing bases or composables, and consolidating inline or duplicate TypeScript types into centralized resources. It also ensures a safe workflow by always creating a separate branch before changes and presenting before/after rename diffs for user approval.

Core Features & Use Cases

  • Detect mixed PT-BR/English names in Vue/TS components and rename to English PascalCase across resources/js.
  • Identify obsolete files that are not imported anywhere in the codebase, with safe exceptions for inertia/vite typings.
  • Flag duplicate or similar components that could share a base or composable, suggesting refactors to Base{Name} components or use of composables.
  • Consolidate inline or duplicate TypeScript types into resources/js/types/, with imports updated across files.
  • Provide a transparent, item-by-item approval workflow before applying changes, including before/after rename diffs and an option to edit suggestions.

Quick Start

Follow the step-by-step plan to run a non-destructive cleanup workflow, review reports for each phase, and approve item-by-item changes before executing them.

Frequently Asked Questions about laravel-raptor-cleanup

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

FAQPage Schema
How do I refactor mixed language component names in a Laravel Vue TypeScript project?▼

To refactor mixed language component names in a Laravel Vue TypeScript project, the skill standardizes PT-BR and English names to English PascalCase across resources/js. It provides before and after rename diffs for item-by-item approval before applying changes.

How do I consolidate duplicate TypeScript types in Vue components?▼

Consolidating duplicate TypeScript types in Vue components involves moving inline definitions into centralized resources/js/types/ directories. This skill identifies duplicates, consolidates them, and automatically updates imports across all affected files for better maintainability.

What is the best way to find and remove unused Vue files in a Laravel Raptor codebase?▼

Finding and removing unused Vue files in a Laravel Raptor codebase requires scanning for files that are not imported anywhere. This skill identifies obsolete files while applying safe exceptions for inertia and vite typings, ensuring non-destructive pruning.

How do I safely rename Vue components without breaking imports?▼

Safely renaming Vue components without breaking imports requires creating a separate branch and automatically updating all import paths. This skill enforces branch safety, provides complete reports before touching files, and requires user approval item-by-item to ensure nothing breaks.

How do I detect duplicate Vue components that could share a composable?▼

Detecting duplicate Vue components that could share a composable involves flagging similar components sharing bases or composables. This skill analyzes the codebase to suggest refactoring into Base{Name} components or utilizing composables to eliminate redundancy.

Does this Laravel code cleanup workflow require manual approval for file changes?▼

Yes, this Laravel code cleanup workflow requires manual approval for file changes. It walks through five phases from branch safety to final fixes, presenting complete reports and item-by-item approval prompts, including an option to edit suggestions, before modifying files.