Suspicious Email Analyzer — Claude Code skill: setup and features
This skill scans incoming emails for phishing attempts, deceptive sender domains, and harmful links. It assesses message authenticity before anyone clicks.
npx skills add claude-office-skills/skills --skill suspicious-email-analyzer -a claude-code
npx skills add claude-office-skills/skills --skill suspicious-email -a claude-codeWhat Suspicious Email Analyzer does
The skill inspects email headers, subject lines, body text, and embedded URLs against known security markers. It flags typosquatted domains like paypa1.com, free mail accounts mimicking businesses, and insecure HTTP links. If you supply raw message headers, it factors SPF, DKIM, and DMARC verification into the assessment.
Output arrives as a structured security report. The agent assigns a threat tier from SAFE to HIGH and outputs a concrete verdict. It highlights psychological pressure, requests for credentials, and dangerous attachments such as .exe or .docm files.
Without the full message body or URL targets, the agent cannot evaluate redirect destinations or spoofed display names. The skill supports English and Chinese, with optimal results on claude-sonnet-4 and claude-opus-4.
What it helps with
- detect typosquatted domains and deceptive sender addresses
- evaluate suspicious URLs without opening them in a browser
- identify social engineering tactics like fake invoices or wire transfer requests
- generate an incident response checklist with clear containment steps
Example prompts for the agent
- Check this email for phishing: sender is
[email protected], subject says my account is restricted. - Analyze this payment notice email to see if it matches an invoice scam.
- Is this message legitimate? Here is the full body, headers, and destination link.
How to install Suspicious Email Analyzer
1Skills CLI (Vercel)
npx skills add claude-office-skills/skills --skill suspicious-email-analyzer -a claude-codenpx skills add claude-office-skills/skills --skill suspicious-email -a claude-code2Manually: put the files in place
~/.claude/skills/suspicious-email/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/suspicious-email/
1Skills CLI (Vercel)
npx skills add claude-office-skills/skills --skill suspicious-email -a codex2Manually: put the files in place
.agents/skills/suspicious-email/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add claude-office-skills/skills --skill suspicious-email -a cursor2Manually: put the files in place
.cursor/skills/suspicious-email/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install claude-office-skills/skills suspicious-email2Manually: put the files in place
.github/skills/suspicious-email/SKILL.md1Skills CLI (Vercel)
npx skills add claude-office-skills/skills --skill suspicious-email -a gemini-cli2Platform CLI
gemini skills install https://github.com/claude-office-skills/skills --path suspicious-emailManually: put the files in place
.devin/skills/suspicious-email/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add claude-office-skills/skills --skill suspicious-email -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about Suspicious Email Analyzer
How do I install Suspicious Email Analyzer in Claude Code?
Run npx skills add claude-office-skills/skills --skill suspicious-email-analyzer -a claude-code in your terminal. You can also place the file directly at ~/.claude/skills/suspicious-email/SKILL.md.
What details should be provided for an accurate scan?
Supply the sender email address, subject line, complete body text, and any embedded links. Providing authentication headers like SPF, DKIM, and DMARC yields the most accurate report.
Which AI models work best with this skill?
The author recommends claude-sonnet-4 and claude-opus-4. It is also compatible with claude-3-5-sonnet, gpt-4, and gpt-4o.
Source text
SKILL.md · MIT
---
# ═══════════════════════════════════════════════════════════════════════════════
# CLAUDE OFFICE SKILL - Enhanced Metadata v2.0
# ═══════════════════════════════════════════════════════════════════════════════
# Basic Information
name: Suspicious Email Analyzer
description: "Analyze emails for phishing, scam indicators, and security threats"
version: "1.0"
author: claude-office-skills
license: MIT
# Categorization
category: productivity
tags:
- email
- security
- phishing
- analysis
department: Security
# AI Model Compatibility
models:
recommended:
- claude-sonnet-4
- claude-opus-4
compatible:
- claude-3-5-sonnet
- gpt-4
- gpt-4o
# Skill Capabilities
capabilities:
- phishing_detection
- security_analysis
- risk_assessment
# Language Support
languages:
- en
- zh
---
# Suspicious Email Analyzer
Analyze emails for phishing attempts, scams, and security threats to protect against fraud.
## Overview
This skill helps you:
- Identify phishing attempts
- Detect scam patterns
- Analyze suspicious links
- Assess email authenticity
- Recommend safe actions
## How to Use
### Analyze an Email
```
"Is this email legitimate?"
"Check this email for phishing"
"Analyze this suspicious message"
```
### Provide Email Content
Include:
- Sender email address
- Subject line
- Full email body
- Any links (don't click them!)
## Threat Indicators
### Red Flags Checklist
```markdown
## Email Security Assessment
### Sender Analysis
- [ ] **Domain mismatch**: Display name doesn't match email domain
- [ ] **Lookalike domain**: microsoft.corn, amaz0n.com
- [ ] **Free email for business**: Official company using gmail.com
- [ ] **Random characters**: [email protected]
- [ ] **No reply-to**: Cannot respond to sender
### Content Analysis
- [ ] **Urgency pressure**: "Act NOW", "Account suspended"
- [ ] **Threat language**: "Legal action", "Account closure"
- [ ] **Too good to be true**: Prize winner, inheritance
- [ ] **Generic greeting**: "Dear Customer" vs your name
- [ ] **Grammar/spelling errors**: Unusual mistakes
- [ ] **Requests sensitive info**: Password, SSN, credit card
- [ ] **Unexpected attachment**: Especially .exe, .zip, .docm
### Link Analysis
- [ ] **Hover reveals different URL**: Display vs actual link
- [ ] **Shortened URLs**: bit.ly, tinyurl hiding destination
- [ ] **HTTP (not HTTPS)**: Insecure for sensitive pages
- [ ] **Misspelled domains**: paypa1.com, netlfix.com
- [ ] **IP address URLs**: http://192.168.1.1/login
- [ ] **Excessive subdomains**: secure.login.verify.site.com
### Technical Indicators
- [ ] **Missing security headers**: SPF, DKIM, DMARC fail
- [ ] **Unusual sending time**: 3 AM from "local bank"
- [ ] **Bulk email markers**: Mass mail headers present
```
## Analysis Output
### Threat Assessment Report
```markdown
# Email Security Analysis
## Summary
| Attribute | Value |
|-----------|-------|
| **Threat Level** | 🔴 HIGH / 🟠 MEDIUM / 🟡 LOW / 🟢 SAFE |
| **Confidence** | [X]% |
| **Verdict** | Likely Phishing / Suspicious / Legitimate |
## Sender Analysis
### Email Address
- **Display Name**: PayPal Security Team
- **Actual Address**: [email protected]
- **Status**: 🔴 SUSPICIOUS
### Issues Found
1. ❌ Domain "paypa1-verify.com" is not official PayPal
2. ❌ Uses number "1" instead of letter "l"
3. ❌ Domain registered 3 days ago
## Content Analysis
### Subject: "Urgent: Your Account Has Been Limited"
- 🔴 Uses urgency tactic
- 🔴 Threatening language
### Body Issues
| Issue | Example | Severity |
|-------|---------|----------|
| Generic greeting | "Dear Customer" | 🟡 Medium |
| Urgency | "within 24 hours" | 🔴 High |
| Threat | "account suspended" | 🔴 High |
| Grammar | "Please to verify" | 🟠 Medium |
### Requests Made
- ❌ Asks to click link
- ❌ Requests login credentials
- ❌ Asks for personal information
## Link Analysis
### Link Found
- **Display**: "Verify Your Account"
- **Actual URL**: http://paypa1-verify.com/login
- **Status**: 🔴 DANGEROUS
### URL Issues
1. ❌ Domain is not paypal.com
2. ❌ Uses HTTP (insecure)
3. ❌ Suspicious path mimics login
## Conclusion
### Verdict: 🔴 PHISHING ATTEMPT
This email shows multiple indicators of a phishing attack:
1. Fake sender domain mimicking PayPal
2. Urgency and threat tactics
3. Link to fraudulent website
4. Request for login credentials
### Recommended Actions
1. ✅ Do NOT click any links
2. ✅ Do NOT reply to this email
3. ✅ Report to [email protected]
4. ✅ Delete the email
5. ✅ If clicked link, change password immediately
```
## Common Scam Types
### Phishing Categories
```markdown
## Phishing Attack Types
### 1. Credential Phishing
**Goal**: Steal login credentials
**Pretends to be**: Banks, email providers, social media
**Tactics**: Fake login pages, urgent account issues
**Example**: "Your account password expires today"
### 2. CEO/Business Email Compromise
**Goal**: Wire transfer fraud
**Pretends to be**: Executive, vendor, partner
**Tactics**: Urgency, authority, secrecy
**Example**: "Please wire $50K for urgent deal, keep confidential"
### 3. Technical Support Scam
**Goal**: Remote access or payment
**Pretends to be**: Microsoft, Apple, ISP
**Tactics**: Fake virus alerts, account compromise
**Example**: "We detected virus on your computer, call now"
### 4. Invoice/Payment Scam
**Goal**: Payment to fraudulent account
**Pretends to be**: Vendor, client, internal
**Tactics**: Fake invoices, changed bank details
**Example**: "Updated bank account for invoice payment"
### 5. Package Delivery Scam
**Goal**: Credentials or malware
**Pretends to be**: FedEx, UPS, USPS, DHL
**Tactics**: Failed delivery, tracking issues
**Example**: "Package could not be delivered, click to reschedule"
### 6. Tax/Government Scam
**Goal**: Personal info or payment
**Pretends to be**: IRS, SSA, government agency
**Tactics**: Legal threats, refund promises
**Example**: "IRS Notice: Immediate action required"
```
### Legitimate vs Phishing Comparison
```markdown
## How to Spot the Difference
### Banking Email Example
| Aspect | Legitimate | Phishing |
|--------|------------|----------|
| From | [email protected] | [email protected] |
| Greeting | "Hi John Smith" | "Dear Customer" |
| Urgency | "Review when convenient" | "IMMEDIATE ACTION REQUIRED" |
| Links | Links to chase.com | Links to chase-verify.com |
| Action | "Log in to your account" | "Enter password here" |
| Tone | Professional, calm | Threatening, urgent |
| Personalization | Account ending 4532 | No specifics |
```
## Action Guidelines
### What To Do
```markdown
## Response Protocol
### If Email is SUSPICIOUS (🔴🟠)
1. ❌ Do NOT click links
2. ❌ Do NOT download attachments
3. ❌ Do NOT reply
4. ❌ Do NOT call numbers in email
5. ✅ Verify through official channels
- Go to official website directly (type URL)
- Call known customer service number
6. ✅ Report the email
- Forward to IT security
- Report to company being impersonated
7. ✅ Delete the email
### If You Already Clicked
1. ✅ Disconnect from internet (if malware suspected)
2. ✅ Change passwords immediately
3. ✅ Enable 2-factor authentication
4. ✅ Monitor accounts for suspicious activity
5. ✅ Run antivirus scan
6. ✅ Report to IT department
7. ✅ Consider credit monitoring if financial info shared
### Reporting Channels
- **Generic phishing**: [email protected]
- **IRS scams**: [email protected]
- **FTC**: reportfraud.ftc.gov
- **Company specific**: Usually [email protected]
```
## Email Header Analysis
### What to Check
```markdown
## Email Header Deep Dive
### Key Headers to Review
| Header | What It Shows |
|--------|---------------|
| From | Displayed sender |
| Return-Path | Actual reply address |
| Received | Server path (bottom = origin) |
| SPF | Sender authorized? |
| DKIM | Signature valid? |
| DMARC | Policy result |
### Authentication Results
| Result | Meaning |
|--------|---------|
| pass | Legitimate |
| fail | Likely spoofed |
| softfail | Possibly spoofed |
| none | No policy set |
```
## Limitations
- Cannot access actual email headers without them being provided
- Cannot verify real-time domain reputation
- Cannot click or analyze live links
- Some sophisticated phishing may pass analysis
- Legitimate emails may have some warning signs
- Human judgment is essential for final decision
© claude-office-skills · MIT · claude-office-skills/skills