# Upgrade Assistant

> Plan a Laravel or PHP upgrade by identifying blockers, risky code paths, and the safest execution order.

- **Type:** Skill
- **Install:** `agentstack add skill-me-shaon-agent-skills-upgrade-assistant`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [me-shaon](https://agentstack.voostack.com/s/me-shaon)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [me-shaon](https://github.com/me-shaon)
- **Source:** https://github.com/me-shaon/agent-skills/tree/main/skills/upgrade-assistant

## Install

```sh
agentstack add skill-me-shaon-agent-skills-upgrade-assistant
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Upgrade Assistant

## When to use

Use this skill when preparing or executing a Laravel framework, first-party package, or PHP upgrade and you need a practical upgrade plan. It is most useful when the app has custom authentication, queues, broadcasting, Horizon, Octane, Livewire, Inertia, Filament, or a large test suite.

## Input parameters

- Current and target Laravel or PHP versions.
- `composer.json`, `composer.lock`, and important first-party or third-party packages.
- Relevant upgrade guide links, changelog snippets, or failing tests.
- Constraints such as freeze windows or required backward compatibility.
- Whether the project uses common Laravel ecosystem packages such as Sanctum, Passport, Cashier, Scout, Horizon, Reverb, Jetstream, Livewire, Inertia, Filament, or Pest.

## Procedure

1. Confirm the current and target Laravel and PHP versions, then decide whether the safest path is a direct jump or incremental major-version upgrades.
2. Inspect `composer.json`, `composer.lock`, `phpunit.xml`, `bootstrap/app.php`, `config/*.php`, custom service providers, middleware registration, exception handling, and package-specific config to identify dependency blockers or published config drift.
3. Review Laravel-specific hotspots such as authentication, route model binding, queued jobs, broadcasting, notifications, custom casts, console commands, macros, test helpers, and any overridden framework internals.
4. Prefer official upgrade guides and package changelogs over guesswork. Call out where framework defaults changed, where published config may need review, and which ecosystem packages are most likely to block the upgrade.
5. Group findings into `Dependency blockers`, `Code changes`, `Config/bootstrap changes`, and `Validation steps`. Be explicit about what must happen before `composer update`, immediately after it, and before deployment.
6. End with a phased plan using these sections: `Preparation`, `Dependency updates`, `Application changes`, `Test pass`, and `Deployment checks`. Include concrete commands, targeted PHPUnit or Pest suites, and smoke-test routes when relevant.
7. Keep the answer concise and practical. Do not dump a generic framework changelog; focus on the changes that matter for the actual app and dependency set.

Output expectations: return dependency blockers first, then a phased upgrade plan with concrete commands, test checkpoints, and deployment checks.

## Examples

Prompt 1:

```text
Use upgrade-assistant to plan a Laravel 11 to 12 upgrade with PHP 8.3. Start with package blockers, config changes, and the safest execution order.
```

Prompt 2:

```text
Help me upgrade this app from PHP 8.2 to 8.3 and Laravel 10 to 12. Focus on dependency blockers, risky framework touchpoints, and test checkpoints.
```

JSON:

```json
{
  "skill": "upgrade-assistant",
  "context": {
    "current": {
      "laravel": "10.x",
      "php": "8.2"
    },
    "target": {
      "laravel": "12.x",
      "php": "8.3"
    },
    "focus": ["dependency_blockers", "config_changes", "test_plan"],
    "packages": ["sanctum", "horizon", "pest", "livewire"]
  }
}
```

## Smoke test

Feed the skill a Laravel app with an older `composer.json`, published config, and a few first-party packages. Verify that the response identifies real dependency blockers, highlights Laravel-specific risk areas, and returns a short phased upgrade plan instead of a generic package-update checklist.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [me-shaon](https://github.com/me-shaon)
- **Source:** [me-shaon/agent-skills](https://github.com/me-shaon/agent-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-me-shaon-agent-skills-upgrade-assistant
- Seller: https://agentstack.voostack.com/s/me-shaon
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.