Official agent skill

Reading Mailcatcher API

by bitwarden in bitwarden/ai-plugins

Retrieves a link from Mailcatcher. An agent skill from bitwarden/ai-plugins.

OfficialCustom licenceAuto-check passedBackend & APIs

Install Reading Mailcatcher API

skills CLI
$ npx skills add bitwarden/ai-plugins --skill reading-mailcatcher-api -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install bitwarden/ai-plugins reading-mailcatcher-api --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/bitwarden/ai-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/bitwarden-mailcatcher-tools/skills/reading-mailcatcher-api .claude/skills/reading-mailcatcher-api && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
reading-mailcatcher-api
GitHub stars
154
Token cost
~2.3k tokens
SKILL.md length
795 words
Files
9 (incl. scripts, references)
Skills in repo
35
Repo updated
First seen
Licence
Custom licence

At a glance

Retrieves a link from Mailcatcher. An agent skill from bitwarden/ai-plugins.

  • A local testing
  • SKILL.md covers Quick reference — use the script, Prerequisites, Common Email Types and Patterns and Important Notes
  • Runs Python scripts from its folder; calls docker
  • Debugging flow needs a link from an email

What it does

Reading Mailcatcher API is an agent skill from bitwarden/ai-plugins, published by the product's own GitHub organization. Retrieves a link from Mailcatcher. Use when a local testing or debugging flow needs a link from an email, such as account verification links, magic-link logins, trial activations, organization invites, emergency access, and other email-driven flows. Preferred over the Mailcatcher browser UI in automation, where Playwright's CORS blocks a direct fetch. Do NOT use it to configure SMTP, start Mailcatcher, or debug delivery.

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including scripts and reference files (for example `evals/README.md`, `evals/trigger-eval.json` and `references/email-patterns.md`).

It sits in Backend & APIs, covering Authentication, Transactional email and Debugging. It works with Playwright. The repository describes itself as: AI plugin marketplace.

When your agent uses it

  • A local testing
  • Debugging flow needs a link from an email
  • Such as account verification links
  • Magic-link logins

Example prompts

  • “Use the reading-mailcatcher-api skill to retrieve a link from Mailcatcher. An agent skill from bitwarden/ai-plugins”
  • “/reading-mailcatcher-api”

Requirements

  • Python 3
  • Docker
  • Pre-approved tools (allowed-tools): Read(/${CLAUDE_PLUGIN_ROOT}/skills/reading-mailcatcher-api/references/**), Bash(${CLAUDE_PLUGIN_ROOT}/skills/reading-mailcatcher-api/scripts/read_mailcatcher.py:*), Bash(${CLAUDE_PLUGIN_ROOT}/skills/reading-mailcatcher-api/scripts/get_admin_email.py:*)

What it can do on your machine

Read from SKILL.md and the folder at commit 3e6bea3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read(/${CLAUDE_PLUGIN_ROOT}/skills/reading-mailcatcher-api/references/**)
    • Bash(${CLAUDE_PLUGIN_ROOT}/skills/reading-mailcatcher-api/scripts/read_mailcatcher.py:*)
    • Bash(${CLAUDE_PLUGIN_ROOT}/skills/reading-mailcatcher-api/scripts/get_admin_email.py:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 4 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • docker

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use docker, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Reading Mailcatcher API loads about 2.3k tokens when it runs, and up to ~4.3k if it reads all its reference files. Until then it costs about 112 tokens; SKILL.md has 795 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~112
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 795 words (~2,300 tokens).

“For all programmatic uses (test runs, ad-hoc fetches, debugging), call the co-located script directly.”

— opening of SKILL.md by bitwarden, Custom licence
name
reading-mailcatcher-api
allowed-tools
Read(/${CLAUDE_PLUGIN_ROOT}/skills/reading-mailcatcher-api/references/**), Bash(${CLAUDE_PLUGIN_ROOT}/skills/reading-mailcatcher-api/scripts/read_mailcatcher.py:*), Bash(${CLAUDE_PLUGIN_ROOT}/skills/reading-mailcatcher-api/scripts/get_admin_email.py:*)
argument-hint
--recipient <email> [--pattern <subject-keyword>] [--link-filter <regex>]

Read the full SKILL.md on GitHub

Files

SKILL.md and 8 other files (scripts, references) in plugins/bitwarden-mailcatcher-tools/skills/reading-mailcatcher-api of bitwarden/ai-plugins.

  • SKILL.md
  • evals/README.md
  • evals/trigger-eval.json
  • references/email-patterns.md
  • references/manual-api-walkthrough.md
  • scripts/get_admin_email.py
  • scripts/read_mailcatcher.py
  • scripts/tests/test_get_admin_email.py
  • scripts/tests/test_read_mailcatcher.py

Open the folder on GitHubat commit 3e6bea3

Compare with similar skills

Reading Mailcatcher API next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Reading Mailcatcher API compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Reading Mailcatcher API this skillbitwarden/ai-plugins154—~2.3kAutomated safety check: PassCustom licence
Playwright Coretestdino-hq/playwright-skill3901 repos~1.4kAutomated safety check: PassMIT
Testingkortix-ai/suna20k—~3.6kAutomated safety check: NotesCustom licence
Playground Website DebuggingWordPress/wordpress-playground2k—~1.9kAutomated safety check: PassGPL-2.0
UI Visual DebuggingNangoHQ/nango13k—~1.3kAutomated safety check: PassCustom licence
E2E Tests Studiomastra-ai/mastra29k—~4.3kAutomated safety check: PassCustom licence

Similar skills

  • Playwright Core

    testdino-hq/playwright-skill

    Battle-tested Playwright patterns for writing and debugging reliable E2E, API, component, visual, accessibility, and security tests.

    390 GitHub starsUsed in 1 repo~1.4k tokens
    Testing & QAAuto-check passed
  • Testing

    kortix-ai/suna

    A skill your agent uses for every Kortix test task, behavior change, bug fix, refactor, API route change, CLI change, SDK change, browser journey, test failure, coverage question, local benchmark…

    20k GitHub stars~3.6k tokensUpdated today
    Testing & QAAuto-check: notes
  • Playground Website Debugging

    WordPress/wordpress-playground

    Debug the WordPress Playground website by running the dev server from source and interacting with it via Playwright MCP.

    2k GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check passed
  • UI Visual Debugging

    NangoHQ/nango

    A skill your agent uses when modifying or visually debugging Nango frontend UI, including packages/webapp, packages/connect-ui, browser interactions, screenshots, and visual regressions.

    13k GitHub stars~1.3k tokensUpdated today
    Testing & QAAuto-check passed
  • E2E Tests Studio

    mastra-ai/mastra

    REQUIRED when modifying any file in packages/playground-ui or packages/playground.

    29k GitHub stars~4.3k tokensUpdated today
    Testing & QAAuto-check passed
  • API Testing

    petrkindlmann/qa-skills

    Test REST and GraphQL APIs with Playwright APIRequestContext, Supertest, or standalone HTTP clients.

    168 GitHub stars~2.7k tokensUpdated 4 mo ago
    Testing & QAAuto-check passed

More from bitwarden/ai-plugins

All 35 skills in this repo
  • Using Stripe CLI

    bitwarden/ai-plugins

    Official

    Query read-only Stripe test-mode data and advance an already-attached test clock.

    154 GitHub stars~3.7k tokensUpdated today
    Auto-check passed
  • Reviewing Claude Config

    bitwarden/ai-plugins

    Official

    Reviews Claude configuration files for security, structure, and prompt engineering quality.

    154 GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • Managing Workflow Secrets

    bitwarden/ai-plugins

    Official

    Bitwarden's canonical pattern for using a secret inside a GitHub Actions job: authenticate to Azure with the OIDC triad, pull the secret from an Azure Key Vault via the bitwarden/gh-actions…

    154 GitHub stars~4k tokensUpdated today
    Auto-check passed
  • Official

    This skill should be used when the user asks to "review the security architecture", "check authentication patterns", "evaluate trust boundaries", "review encryption implementation", "assess…

    154 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Official

    Audits an external (third-party) Claude Code plugin pinned in this marketplace for security risk before it is vendored, and writes the report to a file for downstream posting.

    154 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Action Audit

    bitwarden/ai-plugins

    Official

    Audit GitHub Actions action usage across an org. An agent skill from bitwarden/ai-plugins.

    154 GitHub stars~1.5k tokensUpdated today
    Auto-check passed

Works with

Questions about Reading Mailcatcher API

What does Reading Mailcatcher API do?

Retrieves a link from Mailcatcher. An agent skill from bitwarden/ai-plugins. Reading Mailcatcher API is an agent skill from bitwarden/ai-plugins, published by the product's own GitHub organization. Retrieves a link from Mailcatcher.

When should I use Reading Mailcatcher API?

Reading Mailcatcher API fits situations like: A local testing; debugging flow needs a link from an email; such as account verification links; magic-link logins.

How do I install Reading Mailcatcher API in Claude Code?

Run `npx skills add bitwarden/ai-plugins --skill reading-mailcatcher-api -a claude-code`. Or copy the skill folder (plugins/bitwarden-mailcatcher-tools/skills/reading-mailcatcher-api in bitwarden/ai-plugins) into .claude/skills/reading-mailcatcher-api in your project. Claude Code loads it when a task matches its description.

How do I install Reading Mailcatcher API in Codex?

Run `npx skills add bitwarden/ai-plugins --skill reading-mailcatcher-api -a codex`. Or copy the skill folder (plugins/bitwarden-mailcatcher-tools/skills/reading-mailcatcher-api in bitwarden/ai-plugins) into .agents/skills/reading-mailcatcher-api in your project. Codex loads it when a task matches its description.

Can I use Reading Mailcatcher API in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bitwarden/ai-plugins --skill reading-mailcatcher-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/reading-mailcatcher-api, .gemini/skills/reading-mailcatcher-api, .github/skills/reading-mailcatcher-api and .opencode/skills/reading-mailcatcher-api in your project.

What does Reading Mailcatcher API need to run?

Going by SKILL.md and its folder, Reading Mailcatcher API needs Python for the scripts in its folder and the command-line tools its instructions call (docker). Our summary lists: Python 3; Docker. Its frontmatter pre-approves these tools: Read(/${CLAUDE_PLUGIN_ROOT}/skills/reading-mailcatcher-api/references/**), Bash(${CLAUDE_PLUGIN_ROOT}/skills/reading-mailcatcher-api/scripts/read_mailcatcher.py:*), Bash(${CLAUDE_PLUGIN_ROOT}/skills/reading-mailcatcher-api/scripts/get_admin_email.py:*).

Does Reading Mailcatcher API access the network?

SKILL.md contains no URLs. Its commands use docker, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Reading Mailcatcher API safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Reading Mailcatcher API use?

Reading Mailcatcher API has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Reading Mailcatcher API use?

About 2.3k tokens (SKILL.md is roughly 9.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2k tokens, read only when the agent opens those files.

What are the alternatives to Reading Mailcatcher API?

Skills that share tags, products or a category with Reading Mailcatcher API: Playwright Core (testdino-hq/playwright-skill, 390 stars), Testing (kortix-ai/suna, 20k stars), Playground Website Debugging (WordPress/wordpress-playground, 2k stars) and UI Visual Debugging (NangoHQ/nango, 13k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Reading Mailcatcher API?

bitwarden (a GitHub organization, an official publisher) maintains it in bitwarden/ai-plugins, which has 154 GitHub stars. The repository holds 35 skills in this directory. The repository was last updated on October 9, 2026.

Source: bitwarden/ai-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.