code-quality - SKILL.md Agent Skill

name: code-quality description: Enforces WordPress coding standards using phpcs, phpstan, and rector. Runs linting and static analysis on PHP/CSS/JS code. Triggers: "run phpcs", "run phpstan", "lint", "check code", "fix code style", "coding standards", or when lint errors occur. allowed-tools: Read, Grep, Glob, Bash

Code Quality Standards

Quick Commands

npm run php:lint        # Check PHP style
npm run php:lint-fix    # Auto-fix PHP issues
npm run php:phpstan     # Static analysis
npm run lint:js         # JavaScript
npm run lint:css        # CSS

Project-Specific Rules

Area	Standard
PHP	7.4+, WordPress Coding Standards
Prefixes	`sh`, `simplehistory`, `simple_history`
Text domain	`simple-history`
CSS naming	SuitCSS: `sh-ComponentName-subpart`
Array syntax	Short `[]` not `array()`
Control structures	Always use braces `{}`, never colon syntax

Essential Principles

Always escape output - Use WordPress escaping functions
Prefix everything - All hooks, functions, classes
Run tools after changes - phpcs/phpstan before committing

Detailed Guidelines

php-standards.md - PHP style, happy path, early returns
css-standards.md - SuitCSS naming conventions
js-standards.md - JavaScript conventions
tooling.md - phpcs, phpstan, rector usage
design-principles.md - DRY, YAGNI, refactoring patterns

Related Files

phpcs.xml.dist - PHP_CodeSniffer config
phpstan.neon - PHPStan config