ellipticmarketing/human-code-skills

Human Code guidelines as an AI skill for Laravel Boost.

v1.0.3 2026-06-01 17:02 UTC

Requires

• php: ^8.2
• illuminate/support: ^10.0|^11.0|^12.0|^13.0

MIT

• Human Code

• laravel
• boost
• ai
• skills
• coding-standards
• human-code

README

A Laravel Boost skill package for writing, reviewing, and refactoring Laravel PHP so application code reads like a clear business workflow.

The skill is meant to be used after Laravel Boost's normal guidance. Boost should still handle framework APIs, installed package versions, Laravel best practices, tests, formatting, and package-specific rules. This skill focuses only on readability decisions: method shape, naming, class boundaries, explicit side effects, model behavior, array/data shape clarity, and avoiding overly clever control flow.

What It Encourages

• Public methods that read like a short business checklist.
• Private methods that answer the missing "how" questions.
• Predicate methods that return booleans without mutating state.
• Guard methods that throw for failed business invariants.
• Side effects that are visible in method names.
• Model methods that are honest about whether they persist changes.
• Domain wording over vague names like process, handle, manage, or update.
• Named predicates for business-rule conditions, even when the raw condition is short.

Installation

Install the package in a Laravel application that uses Laravel Boost:

composer require ellipticmarketing/human-code-skills --dev
php artisan boost:install

When Boost prompts you to select optional skills, choose human-code.

If Laravel Boost is already installed, update Boost's generated instructions after requiring the package:

php artisan boost:update

Updating

Update the Composer package, then refresh Boost:

composer update ellipticmarketing/human-code-skills
php artisan boost:update

Local Development

This package follows the Composer-installable Laravel Boost skill structure used by packages such as spatie/guidelines-skills:

resources/boost/skills/human-code/SKILL.md

The service provider exists so Laravel can auto-discover the package. Laravel Boost reads the package's resources/boost directory.

For local testing without using Packagist, require this repository from a Laravel app using a path repository:

{
    "repositories": [
        {
            "type": "path",
            "url": "../path-to/human-code-skills"
        }
    ]
}

Then run:

composer require ellipticmarketing/human-code-skills --dev
php artisan boost:update

Skill File

The actual skill lives at:

resources/boost/skills/human-code/SKILL.md

Edit that file when you want to adjust the readability rules, examples, or final review checklist.