Boost Skills Laravel Package

Getting Started

Minimal Steps

1. Installation:

   composer require sandermuller/boost-skills
   

   • No runtime dependencies; purely a Markdown-based skill catalog.

2. Pair with a Sync Engine:

   • Requires sandermuller/boost-core or laravel/boost to sync skills to your AI agent (e.g., Claude, Cursor, Copilot).
   • Example with Laravel Boost:

     composer require laravel/boost
     php artisan boost:install
     

3. First Use Case:

   • Code Review: Trigger an AI agent to review a PR using the code-review.md skill.
   • Bug Fixing: Use bug-fixing.md for guided debugging.
   • Spec-Driven Dev: Apply spec-driven-implementation.md for test-first workflows.

Where to Look First

• Skills Inventory: Browse the Skills section in the README for available skills (e.g., jira-workflows.md, deployment.md).
• Guidelines: Check the Guidelines section for best practices (e.g., commit messages, PR templates).
• Tag-Gated Extras: Framework-specific skills (e.g., Laravel, Symfony) are tagged and conditionally loaded.

Implementation Patterns

Core Workflow: Skill Integration

1. Sync Skills to AI Agent:

   • Configure config/boost.php to include sandermuller/boost-skills as a skill source:

     'skills' => [
         'sandermuller/boost-skills',
         // Other skill packages...
     ],
     

   • Run the sync command:

     php artisan boost:sync
     

2. Trigger Skills via CLI:

   • Use Laravel Boost’s boost:run command with a skill name:

     php artisan boost:run code-review --file=path/to/pr.diff
     

   • Example for Jira workflows:

     php artisan boost:run jira-workflows --ticket=PROJ-123
     

3. Embed Skills in CI/CD:

   • Add a step in .github/workflows/ci.yml to auto-generate PR reviews:

     - name: Run AI Code Review
       run: php artisan boost:run code-review --file=diff.patch
     

Laravel-Specific Patterns

• Tagged Skills: Use laravel-* tagged skills (e.g., laravel-migrations.md) for framework-specific tasks.
• Artisan Command Hooks: Extend existing commands (e.g., php artisan migrate) with AI assistance:

  // app/Console/Commands/MigrateWithAI.php
  public function handle() {
      $this->call('boost:run', ['skill' => 'laravel-migrations']);
      $this->call('migrate');
  }
  

AI Agent Integration

• Cursor/Copilot: Configure the agent to use the synced skills directory (storage/boost/skills).
• Claude Code: Point to the skills/ directory in your Claude workspace settings.

Gotchas and Tips

Pitfalls

1. No Runtime Code:

   • Skills are pure Markdown; ensure your sync engine (e.g., laravel/boost) is properly configured to parse and distribute them.
   • Fix: Verify boost-core or laravel/boost is installed and the boost:sync command works.

2. Tag Mismatches:

   • Framework-specific skills (e.g., laravel-*) won’t load if the sync engine doesn’t filter by tags.
   • Fix: Check the sync engine’s documentation for tag-based filtering (e.g., --tags=laravel).

3. Skill Overlap:

   • Generic skills (e.g., bug-fixing.md) may conflict with project-specific AI prompts.
   • Fix: Override skills locally by placing custom Markdown files in storage/boost/skills/.

4. AI Agent Limitations:

   • Some agents (e.g., Copilot) may ignore long or complex skills.
   • Fix: Split skills into smaller, focused files (e.g., bug-fixing/debugging.md, bug-fixing/testing.md).

Debugging

• Sync Issues:

  • Run with verbose output:

    php artisan boost:sync --verbose
    

  • Check storage/logs/boost.log for errors.

• Skill Not Loading:

  • Verify the skill exists in vendor/sandermuller/boost-skills/skills/ and isn’t filtered out by tags.

Configuration Quirks

1. Custom Skill Paths:

   • Override the default skill path in config/boost.php:

     'skill_paths' => [
         base_path('custom-skills'),
         base_path('vendor/sandermuller/boost-skills/skills'),
     ],
     

2. Dynamic Skill Loading:

   • Use Laravel’s service provider to load skills dynamically:

     // app/Providers/BoostServiceProvider.php
     public function boot() {
         $this->app->when(AiAgent::class)
             ->needs('$skills')
             ->give(fn () => collect(config('boost.skills'))
                 ->map(fn ($skill) => file_get_contents("vendor/{$skill}/skills/*.md"))
                 ->filter()
                 ->values()
             );
     }
     

Extension Points

1. Add Custom Skills:

   • Place new .md files in storage/boost/skills/ or a custom path (see above).
   • Example: storage/boost/skills/project-specific/release-checklist.md.

2. Modify Existing Skills:

   • Override vendor skills by copying them to storage/boost/skills/ and editing locally.

3. Create Skill Templates:

   • Use the package as a template for your own skill catalog:

     cp -r vendor/sandermuller/boost-skills/skills custom-skills/
     composer require yourname/your-skills
     

4. Integrate with Git Hooks:

   • Auto-trigger skills on pre-commit or pre-push:

     # .git/hooks/pre-commit
     #!/bin/sh
     php artisan boost:run code-review --file=git diff --cached