README

Laravel package that adds Dubbelepunt Design's AI skills and core loading instructions to Laravel Boost.

This package is meant for teams that want AI output aligned with our conventions, architecture decisions, and delivery workflow.

Installation

Install Boost and this package in your Laravel project:

composer require laravel/boost:^2.2 --dev
composer require dubbelepuntdesign/agent-guidelines-skills:^1.0 --dev
php artisan boost:install

During boost:install, select this package from the list. Boost will install the selected skills into your project's .ai directory.

What You Get

Core loader

resources/boost/guidelines/core.blade.php — the entry point. It describes every Dubbelepunt skill in plain Markdown, with instructions for when each one should be activated. Boost reads this file to know which skills are available and under what conditions.

Dubbelepunt skills

All project-specific skills are prefixed with dubbelepunt-:

Skill	When to activate
`dubbelepunt-agent-communication`	Always — governs all agent interactions
`dubbelepunt-php-guidelines`	Writing or reviewing PHP / Blade code
`dubbelepunt-naming-conventions`	Naming any class, method, variable, or column
`dubbelepunt-security`	Any feature touching user input, auth, data, or external calls
`dubbelepunt-testing`	Writing or reviewing PHPUnit tests
`dubbelepunt-dev-tooling`	Running commands or explaining local tooling
`dubbelepunt-git-strategy`	Branching, committing, or opening pull requests
`dubbelepunt-jira-workflow`	Working on a Jira issue
`dubbelepunt-documentation`	Creating or updating project documentation

Additional skills

The package also includes a curated set of task-oriented skills for frontend structure (Laravel Inertia React), web application testing, SEO audits, A/B testing, analytics tracking, and programmatic content.

Tailored to Our Workflow

These skills are intentionally opinionated for the Dubbelepunt Design workflow. They encode how we typically build and review Laravel projects, including conventions around:

architecture and code organisation,
testing strategy and quality checks,
Git workflow and Jira issue handling,
security and documentation standards.

Use them as a strong default baseline for projects that follow our way of working.

Overriding a Skill

If a project needs different behaviour, create a custom skill in your project with the same skill name:

.ai/skills/{skill-name}/SKILL.md

Then run:

php artisan boost:update

Boost will use your custom skill instead of the package version.

Official docs: https://laravel.com/docs/12.x/boost#overriding-skills

Keeping Resources Updated

When dependencies or package guidance changes, refresh local Boost resources:

php artisan boost:update

For Package Maintainers

To test unpublished changes from a local clone, use a Composer path repository in your Laravel app:

{
  "repositories": [
    {
      "type": "path",
      "url": "../agent-guidelines-skills"
    }
  ]
}

Then run:

composer require dubbelepuntdesign/agent-guidelines-skills:^1.0@dev --dev
composer require laravel/boost:^2.2 --dev
php artisan boost:install

dubbelepuntdesign / agent-guidelines-skills

Maintainers

Package info

Statistics

Security