This is a comprehensive PHP modernization workflow that brings legacy codebases up to PHP 8.1 through 8.5 standards. It bundles introspection scripts, reference docs for everything from property hooks to PSR-15 middleware, and a modernize_loop.py that runs Rector, PHPStan, and PHP-CS-Fixer in coordination. The guardrails are the real value here: it won't let you apply readonly to Doctrine entities, won't raise PHPStan levels without regenerating baselines, and enforces strict_types everywhere. Built by Netresearch, it includes 20+ reference files covering edge cases like Doctrine embeddables, API Platform quirks, and the PHPUnit 12 to 13 mock versus stub distinction. Use it when you need to modernize a PHP project methodically instead of guessing which 8.x features are safe to adopt.

install copies · 90 days. Times the install command was copied on this site in the last 90 days, bots filtered.
6
skills.sh installs
450
GitHub stars
62
last updated
Aug 21, 2026

Install

$ npx -y skills add netresearch/php-modernization-skill --skill php-modernization --agent claude-code

Installs into .claude/skills of the current project.

Files

PHP Modernization

Agent contract

  1. Discover: uv run ${CLAUDE_SKILL_DIR}/scripts/introspect.py (cheap), or verify_php_project.py --summary (full, with agent_actions[]).
  2. Drill: ... --check PM-XX per finding. Full output when triaging >3.
  3. Apply: uv run ${CLAUDE_SKILL_DIR}/scripts/modernize_loop.py --mode dry-run. Review transcript before applying.
  4. References: load on demand; do not pre-load.

Reference routing

Sponsors

Details

Repository
github.com/netresearch/php-modernization-skill
Categories
Frontend Development, PHP & Laravel
First seen
Jun 3, 2026
1hookdeck avatarwebhook-handler-patternshookdeck/webhook-skillsBest practices for webhook handlers. Use when implementing the handler sequence (verify first, parse second, handle idempotently), idempotency, error handling, 448skills.sh installs
2davila7 avatarlanggraphdavila7/claude-code-templatesExpert in LangGraph - the production-grade framework for building stateful, multi-actor AI applications. Covers graph construction, state management, cycles and447skills.sh installs
3manutej avatarlinear-dev-acceleratormanutej/luxor-claude-marketplaceAccelerate software development with Linear project management and MCP server integration. Master issue tracking, project workflows, and development automation 446skills.sh installs
4aaronontheweb avatarmailpit-integrationaaronontheweb/dotnet-skillsTest email sending locally using Mailpit with .NET Aspire. Captures all outgoing emails without sending them. View rendered HTML, inspect headers, and verify de443skills.sh installs
5aiko-atami avatarfeature-sliced-designaiko-atami/fsdApply Feature-Sliced Design (FSD) v2.1 architectural methodology to frontend projects. Use when organizing code structure, decomposing features, creating new co440skills.sh installs
6hieutrtr avatarcode-review-securityhieutrtr/ai1-skillsSecurity-focused code review checklist and automated scanning patterns. Use when reviewing pull requests for security issues, auditing authentication/authorizat440skills.sh installs