README

The php-package-ai-skill is a structured AI skill that teaches coding agents how to design and generate professional PHP Composer packages using modern PHP standards, test-driven workflows, and clean architecture.

It provides:

A machine-readable skill manifest
A human-readable architecture and ruleset
Prompt templates for scaffolding and evolving packages
A ready-to-use Claude agent skill

Works with

Claude (Custom Instructions / Agents)
ChatGPT (System Prompts / Projects)
GitHub Copilot Chat
AI agent frameworks that support skills or system instructions

Repository structure

tree .ai/skills
.ai/skills/ 
├── skill.json # Machine-readable manifest 
├── php-composer-package-architect.md # Human-readable skill spec + prompts
└── claude-php-package-architect.md # Claude system instruction skill

How to use it

With Claude

Open Claude → Custom Instructions / Agent Settings
Paste the contents of .ai/skills/claude-php-package-architect.md
Start prompting using the templates in .ai/skills/php-composer-package-architect.md

With PHP

composer require --dev stolt/php-package-ai-skill
composer require --dev netresearch/composer-agent-skill-plugin

Example prompt

You are a PHP package architect.

Create a CLI package called stolt/env-sync-lint that:

Compares .env files
Preserves comments and blank lines
Has a diff, validate, and clean command
Includes full PHPUnit test coverage

License

These skills are licensed under the MIT license. Please see LICENSE.md for more details.

stolt / php-package-ai-skill

Maintainers

Details