- Can I use this package directly in Laravel without Symfony Console?
- No, this package requires Symfony Console, which isn’t natively supported in Laravel’s Artisan. You’ll need to either wrap it in a custom Artisan command or use it as a standalone CLI tool (e.g., `php vendor/bin/list-skills`). For seamless integration, consider a facade or shelling out to the command.
- How do I install this package in a Laravel project?
- Run `composer require stolt/list-skills-command` to install. Since Laravel doesn’t natively support Symfony Console commands, you’ll need to either create a custom Artisan command that shells out to the package or integrate it into a Symfony-based CLI tool within your project.
- What file structure does this package expect for AI skills?
- The package scans for `SKILL.md` files in a `skills/` directory by default. If your project uses a different convention (e.g., `llms.txt` or custom paths), you’ll need to override the discovery logic or configure the package to match your structure.
- Does this work with Laravel 10+?
- Yes, Laravel 10+ uses Symfony 6.3/7.0, which aligns with the package’s dependency requirements (Symfony Console ^5.0|^6.0|^7.0|^8.0). No major conflicts are expected, but test thoroughly in your environment.
- How can I filter skills by tag or version in Laravel?
- The package supports `--tag` and `--stable-version` flags, but since it’s not a native Artisan command, you’d need to either pass these flags via shell execution (e.g., `php vendor/bin/list-skills --tag=ai`) or replicate the filtering logic in a custom Laravel command.
- Is there a way to cache skill discovery for better performance?
- The package scans the filesystem on every run, which could be slow for large projects. You’d need to implement caching manually (e.g., store discovered skills in a config file or database) or fork the package to add built-in caching.
- What happens if `stolt/skill-validator` (a private package) breaks?
- If `stolt/skill-validator` is abandoned or changes, the command may fail. Mitigate this by forking the package, replacing its logic with a public alternative, or implementing basic validation in your own Laravel command wrapper.
- Can I use the JSON output in Laravel for APIs or dynamic UI?
- Yes, the package outputs JSON, which is ideal for APIs or dynamic tooling. You could consume this output in Laravel to generate documentation, UI components, or even dynamically register skills in your application.
- Are there alternatives for listing AI skills in Laravel?
- If you need a Laravel-native solution, consider building a custom Artisan command using Laravel’s filesystem and validation tools. For Symfony-based projects, this package is a solid choice, but for pure Laravel, alternatives like `spatie/laravel-artisan-commands` + custom logic may fit better.
- How do I integrate this into a Laravel Artisan command?
- Create a custom Artisan command that shells out to the package (e.g., `exec('vendor/bin/list-skills')`) or use a facade to call its logic directly. Alternatively, extract the skill discovery logic and adapt it to Laravel’s filesystem and validation systems.