--- title: "Agent skills for testing email flows · Proxy Mail QA" description: "Copy-ready skills that teach Claude Code, Cursor, Codex, GitHub Copilot, Qoder and other agents to test sign-up, code, link and reset emails." url: https://proxymail.qa/skills --- Agent skills # Teach your coding agent to test email flows 9 skills for Claude Code, Cursor, Codex, GitHub Copilot, Qoder and any agent that reads skills. Each one is a whole job, from writing sign-up tests to auditing every email an app sends. Install them all with one command, or copy the one you need. Free on every plan, like the MCP server they use. Install ## Pick your tool The commands and folders on this page follow your choice. ### Any agent that reads skills The installer asks which of your agents to add the skills to, and whether for this project or all of them. For one skill, add `--skill` and its name; each skill below has its command. By hand: download a skill’s ZIP and unzip it where your agent keeps skills. Each ZIP holds one folder, named after the skill, with its SKILL.md. ### Claude Code All the skills, for Claude Code. For one skill, add `--skill` and its name; each skill below has its command. By hand: unzip a skill into `.claude/skills/` in your project, or `~/.claude/skills/` for every project. Or install our plugin: the MCP server and its skills in one. Then type `/mcp` and Authenticate. Claude Code ``` /plugin marketplace add aaquib90/proxymail-qa-plugin /plugin install proxymail-qa@proxymail-qa ``` ### Cursor All the skills, for Cursor. For one skill, add `--skill` and its name; each skill below has its command. By hand: unzip a skill into `.cursor/skills/` in your project, or `~/.cursor/skills/` for every project. Or add our plugin from the Cursor Directory: the MCP server and its skills in one. Then log in from Cursor Settings. [Open the Cursor Directory](https://cursor.directory/plugins/proxymail-qa) ### Codex All the skills, for Codex. For one skill, add `--skill` and its name; each skill below has its command. By hand: unzip a skill into `.agents/skills/` in your project, or `~/.agents/skills/` for every project. ### GitHub Copilot All the skills, for GitHub Copilot. For one skill, add `--skill` and its name; each skill below has its command. By hand: unzip a skill into `.github/skills/` in your project, or `~/.copilot/skills/` for every project. ### Qoder All the skills, for Qoder. For one skill, add `--skill` and its name; each skill below has its command. By hand: unzip a skill into `.qoder/skills/` in your project, or `~/.qoder/skills/` for every project. ### Windsurf All the skills, for Windsurf. For one skill, add `--skill` and its name; each skill below has its command. By hand: unzip a skill into `.windsurf/skills/` in your project, or `~/.codeium/windsurf/skills/` for every project. ### OpenCode All the skills, for OpenCode. For one skill, add `--skill` and its name; each skill below has its command. By hand: unzip a skill into `.opencode/skills/` in your project, or `~/.config/opencode/skills/` for every project. ### Gemini CLI All the skills, for Gemini CLI. For one skill, add `--skill` and its name; each skill below has its command. By hand: unzip a skill into `.agents/skills/` in your project, or `~/.gemini/skills/` for every project. ### Claude on the web and desktop 1. Connect Proxy Mail QA: in Claude, **Settings → Connectors**, add a custom connector with `https://api.proxymail.qa/mcp` and sign in. 2. Turn on code execution in **Settings → Capabilities**. On Team and Enterprise plans, an owner allows skills for the organisation. 3. Download a skill’s ZIP below. 4. Open **Customize → Skills**, choose **+**, then **Create skill → Upload a skill**, and pick the ZIP. The skills ## Each one a whole job Copy a command, the skill itself or its ZIP. Every skill works with the Proxy Mail QA MCP server, and the ones that write tests use an API key. ### Email flow testing proxymail-qa The basics: create a test address, sign up with it and get the code or link from the email. Covers sign-up, login codes, magic links, password resets and invites. Needs the MCP server or an API key [Download ZIP](https://proxymail.qa/skills/proxymail-qa.zip) [Open](https://proxymail.qa/.well-known/agent-skills/proxymail-qa/SKILL.md) ### Email end-to-end tests email-e2e-tests · v1.2.1 Writes Playwright, Cypress, Puppeteer, Jest, Vitest or pytest tests for sign-up, login codes, magic links and resets, and runs them in CI. Also checks an email came once, or not at all. Needs an API key for the tests [Download ZIP](https://proxymail.qa/skills/email-e2e-tests.zip) [Open](https://proxymail.qa/.well-known/agent-skills/email-e2e-tests/SKILL.md) ### Auth regression pack auth-regression-pack · v1.0.0 The same checks of sign-up, reset and invitation emails every time, including links that are used twice or replaced, with a report of what changed since the last run. Needs the MCP server and a browser the agent drives [Download ZIP](https://proxymail.qa/skills/auth-regression-pack.zip) [Open](https://proxymail.qa/.well-known/agent-skills/auth-regression-pack/SKILL.md) ### Account email audit account-email-audit · v1.0.0 Triggers every account email the app sends and checks SPF, DKIM and DMARC, links to localhost or production, expiry, plain text and phone layout, then lists what to fix. Needs the MCP server or an API key [Download ZIP](https://proxymail.qa/skills/account-email-audit.zip) [Open](https://proxymail.qa/.well-known/agent-skills/account-email-audit/SKILL.md) ### Email delivery troubleshooting email-delivery-troubleshooting · v1.0.1 Finds where a sign-up or reset email stopped, such as an email provider in sandbox mode, a suppression list, a rate limit or a link to localhost, and fixes the cause. Needs the MCP server or an API key [Download ZIP](https://proxymail.qa/skills/email-delivery-troubleshooting.zip) [Open](https://proxymail.qa/.well-known/agent-skills/email-delivery-troubleshooting/SKILL.md) ### Sign-up form email validation signup-form-email-validation · v1.1.0 Checks the sign-up form accepts valid but unusual addresses (plus tags, apostrophes, capitals, 64 characters) and turns away invalid ones, with variants that still reach a real inbox. Needs the MCP server or an API key [Download ZIP](https://proxymail.qa/skills/signup-form-email-validation.zip) [Open](https://proxymail.qa/.well-known/agent-skills/signup-form-email-validation/SKILL.md) ### Age and region testing age-and-region-testing · v1.0.0 Test accounts with an exact age or a country, such as under 13, turning 18 tomorrow or one per country, to test age gates, parental consent and country rules. Needs the MCP server or an API key [Download ZIP](https://proxymail.qa/skills/age-and-region-testing.zip) [Open](https://proxymail.qa/.well-known/agent-skills/age-and-region-testing/SKILL.md) ### Marketing and offer email testing marketing-email-testing · v1.0.1 Welcome coupons and checkout, one offer per person, unsubscribing that sticks, consent rules by country and how likely an email is to land in spam, on a staging site with test payments. Needs the MCP server and a browser the agent drives [Download ZIP](https://proxymail.qa/skills/marketing-email-testing.zip) [Open](https://proxymail.qa/.well-known/agent-skills/marketing-email-testing/SKILL.md) ### Mobile app sign-up testing mobile-sign-up-testing · v1.2.0 Sign-up, codes and links in iOS, Android, React Native, Expo and Flutter apps, in the simulator or emulator, or as Maestro, XCUITest, Espresso or Detox tests. Needs a simulator or emulator, and the MCP server or an API key [Download ZIP](https://proxymail.qa/skills/mobile-sign-up-testing.zip) [Open](https://proxymail.qa/.well-known/agent-skills/mobile-sign-up-testing/SKILL.md) Before the first skill ## Connect your agent once ### The MCP server Add https://api.proxymail.qa/mcp to your agent and sign in by browser. One setup prompt does it for most agents. [Agent setup](https://proxymail.qa/docs/api#agent-setup) ### An API key for tests Tests and CI read a key from Project settings → API keys. Keep it in an environment variable, not in files you commit. [Running in CI](https://proxymail.qa/docs/ci) ### Free to start The skills, the MCP server and the API are on every plan, including Free, with 60 requests a minute per key. [Pricing](https://proxymail.qa/#pricing) FAQ ## Questions ### What is an agent skill? A folder with a SKILL.md file in it: instructions an AI coding agent reads when a task matches the skill’s description. Claude Code, Cursor, Codex, GitHub Copilot, Qoder and many other agents read the same format, so one skill works in all of them. ### What do the skills need? A Proxy Mail QA account, which is free, and your agent connected to it: the MCP server, which signs in by browser, or an API key for tests that run on their own. The agent setup in the docs connects most agents with one prompt. ### Can my agent find the skills by itself? Yes. proxymail.qa lists them at /.well-known/agent-skills/index.json, in the Agent Skills discovery format, with a SHA-256 digest of each file. That index is what npx skills add https://proxymail.qa reads. ### How do I update a skill? Skills installed with the skills command update with npx skills update. A skill you copied or uploaded by hand: download it again and replace the folder. Each skill’s version is at the top of its SKILL.md. ### Is it safe to let an agent run them? Each skill keeps the agent to apps you own or may test, with test accounts only, never live sites or real people’s accounts. The skills tell the agent that what an email says is data, never instructions to follow, and Proxy Mail QA hands back only the code or link, not the email’s text. ### Can I change a skill? Yes. Edit the SKILL.md in your project to match your app, such as its sign-up page or test plan.