Skip to main content
skill CX Codex

osint-recon — Claude Code skill: what it does, how to install

Gathers and correlates public intelligence across domains, organizations, and metadata. Helps map attack surfaces and document open-source findings.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add briiirussell/cybersecurity-skills --skill osint-recon -a claude-code
Open on GitHub

What osint-recon does

The skill guides the assistant through systematic reconnaissance across open-source registers, infrastructure records, and document metadata. It supplies specific terminal commands for dig, whois, Certificate Transparency queries via crt.sh, and file inspections using exiftool.

Analysis relies on strict verification standards. Findings require corroboration from independent sources before receiving confidence ratings. The assistant compiles the results into a markdown report covering findings, correlated entities, and intelligence gaps.

Automated checks will fail if command-line utilities like curl, jq, or exiftool are missing from your environment. The instructions explicitly disallow private data scraping, unauthorized access, and doxing attempts.

What it helps with

  • map domain infrastructure using DNS records and Certificate Transparency logs
  • extract author and software metadata from public documents using exiftool
  • cross-reference exposed emails against public breach data
  • generate a structured reconnaissance report with confidence ratings

Example prompts for the agent

  • Run an OSINT assessment on target domain example.com and map its public subdomains.
  • Extract metadata from company-report.pdf and summarize internal author details.
  • Research public registry data and tech stack indicators for target organization Acme Corp.

How to install osint-recon

1Skills CLI (Vercel)

npx skills add briiirussell/cybersecurity-skills --skill osint-recon -a claude-code

2Manually: put the files in place

~/.claude/skills/osint-recon/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/osint-recon/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about osint-recon

How to install osint-recon in Claude Code?

Run npx skills add briiirussell/cybersecurity-skills --skill osint-recon -a claude-code. The skill file will be created at ~/.claude/skills/osint-recon/SKILL.md.

What does osint-recon do?

It guides the agent through gathering publicly accessible threat intelligence on domains, files, and organizations. The skill directs the model to verify facts across independent sources and format an assessment report.

What command-line tools are required for osint-recon?

Live infrastructure queries and document extraction require local CLI tools including whois, dig, curl, jq, and exiftool. The model invokes them via Bash.

Source text

SKILL.md · MIT
---
name: osint-recon
description: "Gather and correlate open source intelligence from public sources for authorized investigations, threat intelligence, and attack surface assessment. Use when the user mentions 'OSINT,' 'open source intelligence,' 'digital footprint,' 'public records,' 'threat intelligence,' 'investigate a domain,' or needs to research a target using publicly available data."
allowed-tools: Bash, WebSearch, WebFetch, Read, Write
---

# OSINT Recon — Open Source Intelligence Gathering

Systematically gather, analyze, and correlate publicly available information from open sources.

Cross-references: `recon` for the active/passive target-mapping pass against an authorized system (DNS, ports, fingerprinting) — osint-recon focuses on people, organizations, leaked data, and historical artifacts; the two pair naturally. `breach-patterns` for ingesting public breach intelligence into your own preemptive assessments. `incident-triage` if OSINT surfaces evidence the user is already compromised.

## Ethics Check

Before proceeding, confirm:
1. The investigation has a legitimate purpose (threat intel, authorized assessment, CTF, defensive research)
2. You are only gathering publicly available information
3. Results will not be used for harassment, stalking, or doxing

Refuse requests that target individuals for harassment or aggregate private information beyond what the objective requires.

## Collection Techniques

### Domain and Infrastructure OSINT

Run these to map a target's infrastructure:

```bash
whois <domain>                  # Registration data
dig any <domain>                # DNS records
```

Query certificate transparency for subdomains:
```bash
curl -s "https://crt.sh/?q=%25.<domain>&output=json" | jq -r '.[].name_value' | sort -u
```

Additional sources: SecurityTrails, DNSDumpster, ipinfo.io, bgp.he.net, Wayback Machine, Shodan, Censys.

### Organization OSINT

- Company registrations, filings, SEC records (public companies)
- LinkedIn company page — employee count, roles, tech stack hints
- Job postings — reveal internal tools, tech stack, pain points
- Press releases and news articles
- GitHub/GitLab organization pages and public repositories
- Patent filings

### Email and Username OSINT

- Email format patterns (e.g., [email protected])
- HaveIBeenPwned — check for breach exposure (check only, never distribute breach data)
- PGP key servers for email discovery
- Gravatar lookups for email-to-identity correlation

### Document and File OSINT

- Extract metadata from public documents: `exiftool <file>` reveals author, software, GPS, timestamps
- Google dorking: `site:<domain> filetype:pdf`, `site:<domain> filetype:xlsx`
- Pastebin and code paste site monitoring
- Public cloud storage enumeration (S3 buckets, GCS buckets with predictable names)

### Threat Intelligence

- CVE databases for the target's technology stack
- Exploit databases (exploit-db, searchsploit)
- Threat feeds and IOC databases (VirusTotal, MalwareBazaar, OTX)
- Abuse contact databases

## Analysis

- Cross-reference findings across multiple sources
- Validate information with at least two independent sources
- Build a timeline of events when investigating incidents
- Map relationships between entities (people, domains, IPs, organizations)
- Rate confidence: **High** (multiple corroborating sources), **Medium** (single reliable source), **Low** (unverified)

## Output Format

```markdown
# OSINT Report
## Objective: [what we're investigating and why]
## Target: [entity/domain/person]
## Date: [date]

### Collection Summary
| Source | Findings | Confidence |
|--------|----------|------------|

### Key Findings

#### Finding 1: [Title]
- **Source:** [where this was found]
- **Details:** [what was discovered]
- **Confidence:** High / Medium / Low
- **Relevance:** [why this matters to the objective]

### Correlations
[How different findings connect to each other]

### Intelligence Gaps
[What we couldn't find or verify]

### Recommendations
[Next steps and actionable intelligence]
```

## Boundaries

- Only use publicly available sources
- Never attempt to access private or authenticated systems
- Do not aggregate PII beyond what is necessary for the stated objective
- Attribute all findings to their source
- Rate confidence levels honestly — do not overstate certainty
- If a finding could cause harm if misused, note the sensitivity
- Refuse requests for doxing, stalking, or unauthorized surveillance

## References

- OSINT Framework (osintframework.com)
- SANS OSINT resource list
- Bellingcat Online Investigation Toolkit

© briiirussell · MIT · briiirussell/cybersecurity-skills

Similar skills

Everything for Security →

From the same set25

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor