List Skills Command Laravel Package

Product Decisions This Supports

• Developer Tooling for AI-Driven Workflows: Enables teams building AI-powered CLI tools (e.g., llms-txt-php-cli) to standardize skill discovery, validation, and metadata management. Aligns with roadmaps for AI agent orchestration or modular AI toolkits.
• Build vs. Buy: Buy for teams already using Symfony Console or PHP-based AI frameworks (e.g., Boost, custom llms.txt ecosystems). Build if needing deeply integrated skill management tied to proprietary metadata schemas.
• Use Cases:
  • CI/CD Integration: Auto-generate skill inventories in JSON for pipeline validation (e.g., "Does this PR add a stable skill?").
  • Developer Onboarding: CLI-driven skill exploration (e.g., list-skills --format-md) for docs or IDE tooltips.
  • AI Agent Discovery: Auto-detect and surface skills to agentic systems (via --format-json + ergebnis/agent-detector).
  • Compliance/Audit: Filter skills by tags/versions (e.g., --tag=security,--stable-version) for governance.

When to Consider This Package

• Adopt if:
  • Your PHP/Laravel project uses custom AI skill files (e.g., llms.txt, Boost conventions) and needs CLI introspection.
  • You’re building a modular AI toolkit where skills are plugins/commands (e.g., validate, init).
  • Your team requires machine-readable skill metadata for CI, agents, or docs (JSON/Markdown output).
  • You’re already using Symfony Console or can integrate a lightweight command layer.
• Look elsewhere if:
  • Skills are managed via non-PHP systems (e.g., Python, Node.js, or proprietary formats).
  • You need runtime skill execution (this is purely discovery/validation).
  • Your metadata schema diverges significantly from Boost’s conventions (custom validation would require forks).
  • You prioritize GUI tools over CLI (e.g., admin dashboards for skill management).

How to Pitch It (Stakeholders)

For Executives: *"This package lets us treat AI skills like first-class CLI commands—think npm list for our PHP-based AI toolkit. It’s a lightweight way to:

• Automate skill inventory for CI/CD (e.g., block unstable skills in PRs).
• Surface capabilities to AI agents via JSON (future-proofing for autonomous workflows).
• Reduce onboarding friction with Markdown tables or verbose metadata. Cost: Zero dev time (drop-in Symfony command). Risk: Minimal (MIT license, 8.2+ PHP). ROI: Faster iteration for AI tooling teams."*

For Engineers: *"Need to list/validate AI skills in PHP? This gives you:

• Symfony Console integration in 2 lines of code.
• Filtering by tags (--tag=ml), versions (--stable), or output format (--format-json for agents).
• Validation hooks (e.g., SKILL.md checks) to catch misconfigured skills early.
• Auto-detection for AI environments (no manual flags needed). Use case: Imagine composer require + this = instant skill discovery for your CLI tool. Tradeoff: Tight coupling to Boost conventions (but extensible via forks)."*