Laravel quality

Skill noppu-labs/ai-toolkit/laravel/skills/laravel-quality

Toolkit for agentic development of Laravel & React apps

Install

npx -y skills add noppu-labs/ai-toolkit --skill laravel-quality

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Code quality tooling with PHPStan, Pint, and strict types. Use when configuring or running static analysis, code style, or linting.

SKILL.md

4.7 KB, as published. Nobody here has run it

Laravel Quality

Testing, static analysis, and code quality enforcement.

Related guides:

code-style.md - Laravel Pint configuration and coding style
type-safety.md - Strict types and type hints
Testing - Comprehensive testing guide

Quality Stack

# composer.json scripts
{
    "test": "pest",
    "analyse": "phpstan analyse",
    "format": "pint",
    "quality": [
        "@analyse",
        "@test"
    ]
}

All files must have declare(strict_types=1) at top. Run quality checks before every commit.

Architecture Tests (Pest)

Enforce conventions with Pest architecture tests when appropriate for the project.

→ Architecture test examples: architecture-tests.md

Static Analysis (PHPStan)

Installation

composer require phpstan/phpstan --dev
composer require phpstan/phpstan-strict-rules --dev
composer require larastan/larastan --dev

Configuration

phpstan.neon

includes:
    - vendor/larastan/larastan/extension.neon
    - vendor/phpstan/phpstan-strict-rules/rules.neon

parameters:
    level: 5  # Minimum 5, increase per-project as practical (up to 8)
    paths:
        - app
        - tests
    excludePaths:
        - app/Providers/TelescopeServiceProvider.php
    checkMissingIterableValueType: true
    checkGenericClassInNonGenericObjectType: true
    reportUnmatchedIgnoredErrors: false

Run

./vendor/bin/phpstan analyse

Code Style (Laravel Pint)

Installation

composer require laravel/pint --dev

Configuration

pint.json

{
    "preset": "laravel",
    "rules": {
        "simplified_null_return": true,
        "no_unused_imports": true,
        "ordered_imports": {
            "sort_algorithm": "alpha"
        }
    }
}

Run

./vendor/bin/pint
./vendor/bin/pint --test  # Check only

Test Coverage

Enable Coverage (Pest)

phpunit.xml

<coverage>
    <report>
        <html outputDirectory="coverage"/>
        <text outputFile="php://stdout"/>
    </report>
</coverage>

Run with Coverage

./vendor/bin/pest --coverage
./vendor/bin/pest --coverage --min=80  # Enforce minimum

CI/CD Checks

GitHub Actions Example

.github/workflows/tests.yml

name: Tests

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v3

      - name: Setup PHP
        uses: shivammathur/setup-php@v2
        with:
          php-version: 8.4
          extensions: dom, curl, libxml, mbstring, zip, pcntl, pdo, sqlite, pdo_sqlite
          coverage: xdebug

      - name: Install Dependencies
        run: composer install --prefer-dist --no-interaction

      - name: Code Style
        run: ./vendor/bin/pint --test

      - name: Static Analysis
        run: ./vendor/bin/phpstan analyse

      - name: Run Tests
        run: ./vendor/bin/pest --coverage --min=80

Pre-commit Hooks

Installation

composer require brainmaestro/composer-git-hooks --dev

Configuration

composer.json

{
    "extra": {
        "hooks": {
            "pre-commit": [
                "./vendor/bin/pint",
                "./vendor/bin/phpstan analyse",
                "./vendor/bin/pest"
            ]
        }
    },
    "scripts": {
        "post-install-cmd": "vendor/bin/cghooks add --ignore-lock",
        "post-update-cmd": "vendor/bin/cghooks update"
    }
}

Quality Metrics

What to Track

Test coverage - Aim for 80%+
PHPStan level - Level 8 (max)
Architecture test pass rate - 100%
Code style violations - 0

Regular Reviews

Weekly - Check test coverage trends
Per PR - Run all quality checks
Monthly - Review architecture compliance
Release - Full quality audit

Common Issues to Watch

Anti-patterns

Domain logic in controllers
Using scopes instead of builders
Missing strict types declaration
Passing primitives instead of DTOs
Jobs/Listeners with domain logic

Type Safety

Missing return types
Missing parameter types
Missing property types
Untyped arrays/collections

Testing

Missing feature tests for endpoints
Missing unit tests for actions
Low coverage on critical paths
Brittle tests (too many mocks)

Enforcement Strategy

Architecture tests - Automated checks
PR reviews - Manual verification
CI/CD gates - Block failing builds
Team standards - Document + training
Pair programming - Share knowledge

One thing to look at

What its author says it does

SKILL.md

Laravel Quality

Quality Stack

Architecture Tests (Pest)

Static Analysis (PHPStan)

Installation

Configuration

Run

Code Style (Laravel Pint)

Installation

Configuration

Run

Test Coverage

Enable Coverage (Pest)

Run with Coverage

CI/CD Checks

GitHub Actions Example

Pre-commit Hooks

Installation

Configuration

Quality Metrics

What to Track

Regular Reviews

Common Issues to Watch

Anti-patterns

Type Safety

Testing

Enforcement Strategy

Keep looking