Payum agent skills

Skills that teach AI coding agents how to integrate Payum, the framework-agnostic PHP payment library: setting up gateways, taking payments, handling webhooks and storing payment state.

Each skill is a folder with a SKILL.md file in the open Agent Skills format, so the same files work in Claude, Codex, Cursor, Gemini CLI, GitHub Copilot and the other agents that support the standard. An agent loads only a skill's name and description up front and reads the rest when your request matches it.

Skills

Skill	What it does
payum-migrate-gateway	Ports a Payum 1.x gateway package to the 2.x gateway, config and handler structure, in one go or one piece at a time, keeping backward compatibility
payum-create-gateway	Builds a new Payum 2.x gateway for a payment provider from its online docs: handlers, webhooks, metadata, capabilities and tests, with an official SDK where one exists

Install

Any agent: the skills CLI

The quickest route for most agents. It detects which agents you have installed and copies the skills into each one's skills folder. Needs Node.js 22.20 or later.

npx skills add Payum/agent-skills              # pick skills and agents interactively
npx skills add Payum/agent-skills --list       # see what is available
npx skills add Payum/agent-skills --skill <name> -a claude-code

Add -g to install for your user instead of the current project.

Claude Code

Install as a plugin, so /plugin keeps the skills up to date:

/plugin marketplace add Payum/agent-skills
/plugin install payum@payum

Gemini CLI

gemini extensions install https://github.com/Payum/agent-skills
gemini extensions update payum    # later, to pick up new skills

Codex, Cursor, GitHub Copilot, OpenCode, Windsurf and others

Use the skills CLI above. To install by hand, copy a skill folder into your project's .agents/skills/ directory, which most agents read (Claude Code reads .claude/skills/):

git clone https://github.com/Payum/agent-skills
cp -r agent-skills/skills/<name> your-project/.agents/skills/

Claude.ai, Claude Desktop and ChatGPT

These apps take a skill as a zip upload. Download the skill's zip from the latest release and upload it from the Skills section of the app's settings. Upload one zip per skill.

Contributing

Read CLAUDE.md before adding or changing a skill; it lists what every skill needs. In short:

python3 scripts/skills.py new <name> "<what it does and when to use it>"
# write skills/<name>/SKILL.md
python3 scripts/skills.py validate

Skills run with the permissions of whoever installs them. Read a skill's SKILL.md and any scripts it ships before installing it, here or anywhere else.

License

MIT. See LICENSE.