{
  "markdown": "<div align=\"center\">\n\n# SumUp Skills\n\n[![Documentation][docs-badge]](https://developer.sumup.com)\n[![License](https://img.shields.io/github/license/sumup/sumup-go)](./LICENSE)\n\n</div>\n\nA collection of [Agent Skills](https://agentskills.io/home) for building SumUp payment integrations across card-present (terminal) and card-not-present (online) checkout flows.\n\n## Installing\n\nThese skills work with agents that support the Agent Skills standard, including Claude Code, Cursor, Gemini CLI, OpenCode, OpenAI Codex, and Pi.\n\n### Claude Code\n\nInstall using the plugin marketplace:\n\n```bash\n/plugin marketplace add sumup/sumup-skills\n/plugin install sumup@sumup\n```\n\n### Cursor\n\nInstall from the Cursor Marketplace or add manually via **Settings > Rules > Add Rule > Remote Rule (Github)** with `sumup/sumup-skills`.\n\n### Gemini CLI\n\nInstall the extension from GitHub:\n\n```bash\ngemini extensions install https://github.com/sumup/sumup-skills --ref=main\n```\n\n### OpenAI Codex\n\nInstall using the Codex plugin marketplace:\n\n```bash\ncodex plugin marketplace add sumup/sumup-skills\n```\n\n### Kiro\n\nImport this repository as a custom power from Kiro: **Powers > Add Custom Power > Import power from GitHub**.\n\nFor local testing, use **Import power from a folder** and select this repository root.\n\n### Agent Skills Discovery\n\nAgents and tools that support the [Agent Skills Discovery RFC](https://github.com/cloudflare/agent-skills-discovery-rfc) can discover the SumUp skills from:\n\n`https://developer.sumup.com/.well-known/agent-skills/index.json`\n\nUse this URL in clients that accept a discovery index or start from `https://developer.sumup.com` when the client discovers well-known skill indexes automatically.\n\n### Clone / Copy\n\nClone this repo and copy the skill folders into the appropriate directory for your agent:\n\n| Agent | Skill Directory | Docs |\n|-------|-----------------|------|\n| Claude Code | `~/.claude/skills/` | [docs](https://code.claude.com/docs/en/skills) |\n| Cursor | `~/.cursor/skills/` | [docs](https://cursor.com/docs/context/skills) |\n| Gemini CLI | `~/.gemini/extensions/` | [docs](https://geminicli.com/docs/extensions/) |\n| OpenCode | `~/.config/opencode/skills/` | [docs](https://opencode.ai/docs/skills/) |\n| OpenAI Codex | `~/.codex/skills/` | [docs](https://developers.openai.com/codex/skills/) |\n| Pi | `~/.pi/agent/skills/` | [docs](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent#skills) |\n\n## Skills\n\nInstall using the `npx skills` CLI:\n\n```bash\nnpx skills add https://github.com/sumup/sumup-skills\n```\n\nSkills are contextual and auto-loaded based on your conversation. When a request matches a skill's triggers, the agent loads and applies that skill.\n\n| Skill | Useful for |\n|-------|------------|\n| [sumup](./skills/sumup/) | Implementing SumUp checkout flows end-to-end across Checkouts API, Card Widget, Hosted Checkout, recurring tokenization, and terminal/cloud reader checkouts |\n| [sumup-best-practices](./skills/sumup-best-practices/) | Choosing the right integration path and security posture across Hosted Checkout, Card Widget, Checkouts API, mobile SDKs, terminal SDKs, and Cloud API |\n| [upgrade-sumup](./skills/upgrade-sumup/) | Planning and executing SumUp API/SDK upgrades and migrations across server and mobile SDK surfaces |\n| [sumup-debug](./skills/sumup-debug/) | Diagnosing and fixing common integration failures such as webhook signature mismatches, scope issues, session expiry, widget mount failures, and duplicate references |\n| [sumup-mcp](./skills/sumup-mcp/) | Configuring and using the SumUp MCP server (`https://mcp.sumup.com/mcp`) from MCP-capable clients |\n| [sumup-testing](./skills/sumup-testing/) | Setting up sandbox test merchants, running success/failure scenarios (including `amount = 11`), and validating end-to-end checkout behavior |\n\n## Resources\n\n- [SumUp Developer Documentation](https://developer.sumup.com)\n- [SumUp API Reference](https://developer.sumup.com/api)\n- [SumUp MCP Server](https://mcp.sumup.com/mcp)\n\n[docs-badge]: https://img.shields.io/badge/SumUp-documentation-white.svg?logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgY29sb3I9IndoaXRlIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgogICAgPHBhdGggZD0iTTIyLjI5IDBIMS43Qy43NyAwIDAgLjc3IDAgMS43MVYyMi4zYzAgLjkzLjc3IDEuNyAxLjcxIDEuN0gyMi4zYy45NCAwIDEuNzEtLjc3IDEuNzEtMS43MVYxLjdDMjQgLjc3IDIzLjIzIDAgMjIuMjkgMFptLTcuMjIgMTguMDdhNS42MiA1LjYyIDAgMCAxLTcuNjguMjQuMzYuMzYgMCAwIDEtLjAxLS40OWw3LjQ0LTcuNDRhLjM1LjM1IDAgMCAxIC40OSAwIDUuNiA1LjYgMCAwIDEtLjI0IDcuNjlabTEuNTUtMTEuOS03LjQ0IDcuNDVhLjM1LjM1IDAgMCAxLS41IDAgNS42MSA1LjYxIDAgMCAxIDcuOS03Ljk2bC4wMy4wM2MuMTMuMTMuMTQuMzUuMDEuNDlaIiBmaWxsPSJjdXJyZW50Q29sb3IiLz4KPC9zdmc+\n",
  "bytes": 4742,
  "sha": "0980ad81ca8eb6af47743b9dfe243ff16a6ac5e24632eceba95311bd3a58f94f",
  "repo_slug": "sumup/sumup-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_sumup_sumup_skills_sumup_9c38f79d/readme"
}