skills.rest
laravel
laravelOFFICIAL
Explore all skills by this author →
Website𝕏@laravelphpGitHub

starter-kit-upgrade

Pulls selected upstream features from Laravel starter kits into customized projects on dedicated branches.

713|29|Updated Jan 9, 2026
Search Tags:#starter kit#Git#Laravel#upgrade#PHP#upstream sync#feature migration
One-click install
npx skills add https://github.com/laravel/agent-skills --skill starter-kit-upgrade
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: starter-kit-upgrade
Source: https://github.com/laravel/agent-skills/tree/main/laravel/skills/starter-kit-upgrade
Command: npx skills add https://github.com/laravel/agent-skills --skill starter-kit-upgrade

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Projects bootstrapped from Laravel starter kits (Vue, React, Svelte, Livewire) diverge from upstream immediately, and there is no shared git history to merge against. This Skill lets you selectively pull individual upstream improvements—like toast notifications or a 2FA fix—into your customized project without full version upgrades or risky auto-merges.

Core Features & Use Cases

  • Feature-by-feature upgrades: Enumerate recent upstream commits and PRs, pick specific features, and apply each as its own revertable commit on a dedicated branch.
  • Safety-first conflict handling: Customized files, manifests, and lockfiles are never auto-merged; every difference is surfaced for an explicit user decision.
  • Behavior preservation verification: Records a test/typecheck/build baseline before changes and compares after, flagging only genuine regressions.
  • Use Case: Your Vue starter kit project needs the new toast notification feature from upstream. The Skill detects your kit and branch variant, applies the feature's files, checks transitive imports, and verifies your tests still pass.

Quick Start

Ask the agent to sync the latest toast notification feature from the Laravel Vue starter kit into your project.

Frequently Asked Questions about starter-kit-upgrade

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

FAQPage Schema
How do I pull upstream features from a Laravel starter kit into my project?▼

Run the starter-kit-upgrade skill, which detects your kit (Vue, React, Svelte, or Livewire) and branch variant, lists recent upstream commits and merged PRs as a feature catalog, and applies your selections one at a time on a dedicated branch with individual commits.

How do I update a customized Laravel starter kit project without losing my changes?▼

The skill never auto-merges customized files. It classifies each file as new, already-present, differs, deleted-upstream, or lockfile, then walks you through each difference so you choose to take upstream, keep yours, or merge by hand.

Can I upgrade Laravel 12 to 13 or Livewire 3 to 4 with this skill?▼

No. Major framework bumps are explicitly out of scope because they are too large for the feature-by-feature flow. The skill directs you to run the corresponding Laravel Boost MCP slash command first, then re-run this skill afterward.

What tools are required to run the starter kit upgrade workflow?▼

You need git, an authenticated GitHub CLI (gh), jq, and bash. The preflight script verifies all of these plus a clean working tree before any changes are made, and stops with install instructions if anything is missing.

What happens if my tests fail after applying an upstream feature?▼

The skill records a baseline of your tests, typecheck, and build before applying changes, then compares afterward. A previously-passing check that now fails is treated as a regression: it recommends git revert and never edits code to force a pass.

Does the starter kit upgrade skill overwrite composer.json or lockfiles?▼

No. Manifests and lockfiles are never silently overwritten. The skill shows you the upstream diff, lets you edit the manifest yourself, then regenerates lockfiles via composer install or your detected JS package manager as a separate commit.

Related Skills

Explore More Software Engineering Skills→
breath103breath103
16

tss-update-template

Merge template/main into the current branch to sync with upstream template.

Community
Intermediate
beekeeper-labbeekeeper-lab
1

Deploy

Promote a test branch to main via pull request after tests and lint pass.

Community
Advanced
karuhun-developerkaruhun-developer
5

livewire-development

Create, debug, and optimize Livewire components for Laravel applications.

Official
Intermediate
MisterVitoProMisterVitoPro

code-atlas:update

Incrementally update Code Atlas architecture index entries using file-hash diffing.

Community
Advanced