php-update-with-rector

Upgrades a PHP project to a newer PHP version using Rector — the automated refactoring tool. Inspects composer.json, detects the current PHP version, selects safe PHP-level rulesets, updates dependencies conservatively, runs a dry-run first, and produces an upgrade checklist with follow-up manual changes. Activate for phrases like "upgrade my PHP version", "modernize PHP syntax", "migrate to PHP 8.3", "fix PHP 8 deprecations", "set up Rector for PHP upgrade", or any request to automate PHP syntax modernization — even when Rector is not mentioned by name.

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-sequenced upgrade guide with executable code, a validation-first execution order, and error-recovery guidance. Its only weakness is mild redundancy in the goals section and the absence of progressive disclosure via separate reference files.

Suggestions

Remove or compress the 'Core Goals' section since it duplicates the Step 1–6 headings that follow, saving tokens.

Move the 'Available PHP level sets' table and 'Common Errors' table into a references/ file (e.g. references/sets-and-errors.md) and link to them, enabling progressive disclosure and a leaner SKILL.md.

Trim obvious inline code comments like '// modernizes patterns' and '// adjust to target' that Claude can infer from the constant names.

Dimension	Reasoning	Score
Conciseness	Mostly lean and actionable with no over-explanation of PHP/Rector basics, but the 'Core Goals' section restates the numbered steps that follow and a few inline comments are slightly redundant, keeping it just below the top anchor.	4 / 5
Actionability	Fully executable throughout — copy-paste bash commands ('composer require rector/rector --dev', 'vendor/bin/rector process --dry-run'), complete recto r.php config, exact LevelSetList constants, and a withPhpSets example covering the common cases.	5 / 5
Workflow Clarity	A clearly sequenced Step 1–6 process with an explicit Safe Execution Sequence that includes validation checkpoints (dry-run preview, static analysis, tests) and a feedback loop ('Review the diff, adjust rector.php if needed, repeat dry-run'), plus a deliverables checklist and common-errors recovery table.	5 / 5
Progressive Disclosure	Well-organized into clearly headed sections with compact, appropriately-inline reference material (sets table, common errors), but there are no bundle files or one-level-deep references to offload the ~200 lines of detail, so it does not fully match the split-file top anchor.	4 / 5
	Total	18 / 20 Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, third-person description that pairs concrete capability statements with an explicit, natural-language activation clause and version-specific trigger phrases. It is concise, comprehensive, and clearly distinguishable from other skills.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'Inspects composer.json', 'detects the current PHP version', 'selects safe PHP-level rulesets', 'updates dependencies conservatively', 'runs a dry-run first', 'produces an upgrade checklist' — giving comprehensive coverage of the skill's capabilities.	5 / 5
Completeness	Explicitly answers both 'what' (the upgrade workflow and deliverables) and 'when' via 'Activate for phrases like...' with concrete trigger phrases, matching the top anchor.	5 / 5
Trigger Term Quality	Provides natural user phrases including 'upgrade my PHP version', 'modernize PHP syntax', 'migrate to PHP 8.3', 'fix PHP 8 deprecations', and 'set up Rector for PHP upgrade', covering synonyms and version-specific variants a user would actually say.	5 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (Rector-driven PHP version upgrades) with distinct, version-specific triggers and minimal overlap risk with unrelated skills.	5 / 5
	Total	20 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: masterfermin02/laravel-agent-skill
Path: skills/php-update-with-rector/SKILL.md
Commit: 22c7c54

Reviewed: 7 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.