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.