How do I install the Gravatar Check skill?

Run npx skillmds@latest add mearman/gravatar-check in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Gravatar Check safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gravatar Check?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gravatar Check free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Gravatar Check?

Mearman (@mearman) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gravatar Check by mearman — Agent Skill

Name: Gravatar Check
Author: Mearman

File contents

Check Gravatar Availability

Check if a Gravatar avatar exists for an email address.

Script Execution (Preferred)

npx tsx scripts/check.ts <email> [options]

Options:

--no-cache - Bypass cache and fetch fresh data

Run from the gravatar plugin directory: ~/.claude/plugins/cache/gravatar/

How It Works

Uses a HEAD request with d=404 parameter to check if a Gravatar exists:

If Gravatar exists: Returns 200 OK
If no Gravatar: Returns 404 Not Found

Results are cached for 24 hours to avoid redundant API calls.

Usage

npx tsx scripts/check.ts <email> [options]

Arguments

Argument	Required	Description
`email`	Yes	Email address to check for Gravatar

Options

Option	Description
`--no-cache`	Bypass cache and fetch fresh data from Gravatar

Output

When Gravatar exists:

Checking: user@example.com

✓ Gravatar exists
  Hash: b48bf4373d7b7374351c0544f36f7fc3
  URL: https://www.gravatar.com/avatar/b48bf4373d7b7374351c0544f36f7fc3
  Profile: https://www.gravatar.com/b48bf4373d7b7374351c0544f36f7fc3

When no Gravatar found:

Checking: nonexistent@example.com

✗ No Gravatar found
  Hash: abc123def456789...
  This email does not have a Gravatar image.
  A default image will be shown.

Examples

Check if developer has Gravatar:

npx tsx scripts/check.ts beau@dentedreality.com.au

Bypass cache for fresh check:

npx tsx scripts/check.ts user@example.com --no-cache

Use Cases

Validate Email Addresses

Check if an email is associated with a Gravatar profile:

npx tsx scripts/check.ts contact@company.com

Bulk User Verification

Check multiple team members:

for email in dev1@company.com dev2@company.com; do
  npx tsx scripts/check.ts "$email"
done

Conditional Avatar Display

Verify Gravatar exists before displaying avatar in UI:

npx tsx scripts/check.ts user@example.com && echo "Show Gravatar" || echo "Show default"

Caching

Results are cached for 24 hours. Since Gravatars change infrequently, caching improves performance while maintaining accuracy.

Use --no-cache when you need real-time verification.

Exit Codes

0 - Success (Gravatar exists or check completed)
1 - Error (invalid usage or network error)

Note: A "No Gravatar found" result is still exit code 0 - it's a successful check that returned no avatar.

Use gravatar-url skill to generate Gravatar URLs
Use gravatar-download skill to download Gravatar images
Combine with GitHub/npm user lookups to check developer avatars

---name: gravatar-checkdescription: Check if a Gravatar exists for an email address. Use when the user wants to verify if someone has a Gravatar, check avatar availability, or validate email addresses against Gravatar's database.---# Check Gravatar AvailabilityCheck if a Gravatar avatar exists for an email address.## Script Execution (Preferred)```bashnpx tsx scripts/check.ts <email> [options]```Options:- `--no-cache` - Bypass cache and fetch fresh dataRun from the gravatar plugin directory: `~/.claude/plugins/cache/gravatar/`## How It WorksUses a HEAD request with `d=404` parameter to check if a Gravatar exists:- If Gravatar exists: Returns 200 OK- If no Gravatar: Returns 404 Not FoundResults are cached for 24 hours to avoid redundant API calls.## Usage```bashnpx tsx scripts/check.ts <email> [options]```### Arguments| Argument | Required | Description ||----------|----------|-------------|| `email` | Yes | Email address to check for Gravatar |### Options| Option | Description ||--------|-------------|| `--no-cache` | Bypass cache and fetch fresh data from Gravatar |### OutputWhen Gravatar exists:```Checking: user@example.com✓ Gravatar exists Hash: b48bf4373d7b7374351c0544f36f7fc3 URL: https://www.gravatar.com/avatar/b48bf4373d7b7374351c0544f36f7fc3 Profile: https://www.gravatar.com/b48bf4373d7b7374351c0544f36f7fc3```When no Gravatar found:```Checking: nonexistent@example.com✗ No Gravatar found Hash: abc123def456789... This email does not have a Gravatar image. A default image will be shown.```## ExamplesCheck if developer has Gravatar:```bashnpx tsx scripts/check.ts beau@dentedreality.com.au```Bypass cache for fresh check:```bashnpx tsx scripts/check.ts user@example.com --no-cache```## Use Cases### Validate Email AddressesCheck if an email is associated with a Gravatar profile:```bashnpx tsx scripts/check.ts contact@company.com```### Bulk User VerificationCheck multiple team members:```bashfor email in dev1@company.com dev2@company.com; do npx tsx scripts/check.ts "$email"done```### Conditional Avatar DisplayVerify Gravatar exists before displaying avatar in UI:```bashnpx tsx scripts/check.ts user@example.com && echo "Show Gravatar" || echo "Show default"```## CachingResults are cached for 24 hours. Since Gravatars change infrequently, caching improves performance while maintaining accuracy.Use `--no-cache` when you need real-time verification.## Exit Codes- `0` - Success (Gravatar exists or check completed)- `1` - Error (invalid usage or network error)Note: A "No Gravatar found" result is still exit code 0 - it's a successful check that returned no avatar.## Related- Use `gravatar-url` skill to generate Gravatar URLs- Use `gravatar-download` skill to download Gravatar images- Combine with GitHub/npm user lookups to check developer avatars

Frequently asked questions

Gravatar Check