# Agent Skills

[Agent Skills](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills) let AI coding assistants load focused instructions for specific tasks. We publish SumUp skills in the [`sumup/sumup-skills`](https://github.com/sumup/sumup-skills) repository to help you build terminal and online payment integrations faster and with fewer mistakes.

## Install Skills

If your assistant supports standard Agent Skills folders, install the SumUp skills with:

```bash
npx skills add https://github.com/sumup/sumup-skills
```

You 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](/tools/llms/plugins/).

## Discover Skills

Agents and tools that support the [Agent Skills Discovery RFC](https://github.com/cloudflare/agent-skills-discovery-rfc) can discover the SumUp skills from:

```txt
https://developer.sumup.com/.well-known/agent-skills/index.json
```

Use this URL in clients that accept a discovery index. Clients that automatically check well-known locations can start from:

```txt
https://developer.sumup.com
```

## 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

After installation, ask your assistant to use the relevant SumUp skill for checkout work, for example:

- "Use `$sumup` to build a Cloud API payment flow for Solo."
- "Use `$sumup` to implement a Card Widget checkout with server-side checkout creation."
- "Use `$sumup-debug` to troubleshoot 3DS and webhook handling for online payments."

## Related

- [Plugins](/tools/llms/plugins/)
- [LLMs overview](/tools/llms/)
- [Agentic workflows](/tools/llms/agent-toolkit/)
- [SumUp MCP Server](https://mcp.sumup.com/mcp)