skills: Instructions file for Codex

AGENTS.md

A Composer plugin for discovering and syncing AI agent skills from PHP packages.

Project Overview

This Composer plugin enables automatic discovery and installation of AI agent "skills" (prompts, instructions, templates) from PHP packages. It syncs skill files from dependencies into a project's .claude/skills directory.

Key Features

• Package Discovery: Scans all installed Composer packages for skill definitions
• Three Discovery Modes:
  • Discovery mode: Auto-discovers skills from folders (each folder = one skill, all files included)
  • Explicit mode: Skills defined manually in composer.json with file mappings
  • Mixed mode: Combine discovery with explicit overrides
• Override Protection: Won't overwrite existing files unless --override flag is used
• Flexible Configuration: Supports both skills and agentskills keys in composer.json

Commands

• composer agents:skills:sync - Sync skills to the project
• composer agents:skills:list - List all discovered skills

Requirements

• PHP: >=8.2
• Architecture: Composer plugin with PSR-4 autoloading

Development

# Install dependencies
make install

# Run all quality checks (phpstan + code style)
make qa

# Run code style checks
make cs

# Fix code style issues automatically
make csf

# Run static analysis (PHPStan level 9)
make phpstan

# Run test suite
make tests

# Generate code coverage
make coverage