Agent Skills
Use SumUp Agent Skills in AI coding assistants when building payment integrations.
Agent Skills(Opens in a new tab) let AI coding assistants load focused instructions for specific tasks. We publish SumUp skills in the sumup/sumup-skills(Opens in a new tab) repository to help you build terminal and online payment integrations faster and with fewer mistakes.
Install Skills
Section titled “Install Skills”If your assistant supports standard Agent Skills folders, install the SumUp skills with:
npx skills add https://github.com/sumup/sumup-skillsYou can also clone the repository and copy the skill folders into your assistant’s skill directory.
| Agent | Skill directory |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Cursor | ~/.cursor/skills/ |
| OpenCode | ~/.config/opencode/skills/ |
| OpenAI Codex | ~/.codex/skills/ |
| Pi | ~/.pi/agent/skills/ |
For packaged editor and assistant integrations, see Plugins.
Discover Skills
Section titled “Discover Skills”Agents and tools that support the Agent Skills Discovery RFC(Opens in a new tab) can discover the SumUp skills from:
https://developer.sumup.com/.well-known/agent-skills/index.jsonUse this URL in clients that accept a discovery index. Clients that automatically check well-known locations can start from:
https://developer.sumup.comAvailable Skills
Section titled “Available Skills”sumup: Implementing SumUp checkout flows end-to-end across Checkouts API, Card Widget, Hosted Checkout, recurring tokenization, and terminal flows.sumup-best-practices: Choosing the right integration path and security posture across online, mobile, terminal SDK, and Cloud API integrations.upgrade-sumup: Planning and executing SumUp API and SDK upgrades across server and mobile surfaces.sumup-debug: Diagnosing integration failures such as webhook signature mismatches, scope issues, session expiry, widget failures, and duplicate refs.sumup-mcp: Configuring and using the SumUp MCP server (https://mcp.sumup.com/mcp) from MCP-capable clients.sumup-testing: Setting up sandbox test merchants, running success and failure scenarios, and validating end-to-end checkout behavior.
Use Skills
Section titled “Use Skills”After installation, ask your assistant to use the relevant SumUp skill for checkout work, for example:
- “Use
$sumupto build a Cloud API payment flow for Solo.” - “Use
$sumupto implement a Card Widget checkout with server-side checkout creation.” - “Use
$sumup-debugto troubleshoot 3DS and webhook handling for online payments.”