Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on Windows
8 Claude skills · 100+ recon capabilities · 80 secret-regex patterns · 80+ dorks · 9 read-only credential validators · 27 attack-path templates · ~10,000 lines of structured tradecraft. Drop-in SKILL.md files that turn Claude into a god-mode external recon operator for authorized red-team and bug-bounty engagements.
Saved setup from 5 h ago
Will it work on Windows?
winget install Git.Git) or WSL2 (wsl --install).docs/installation.mdThese skills are plain Markdown files. Installing them depends on which Claude surface you're using.
Claude Code looks for skills in ~/.claude/skills/ by default.
git clone https://github.com/elementalsouls/Claude-OSINT.git
cd Claude-OSINT
# Optional: populate full SKILL.md content from bundled full-skills (one-time after clone)
./scripts/sync-skill-content.sh
# Copy all 8 skills into your local Claude Code skills directory
mkdir -p ~/.claude/skills
cp -r skills/* ~/.claude/skills/
# Or install only the core recon pair (skip the six org-grade depth skills):
# cp -r skills/osint-methodology skills/offensive-osint ~/.claude/skills/
git clone https://github.com/elementalsouls/Claude-OSINT.git ~/.local/share/Claude-OSINT
mkdir -p ~/.claude/skills
# Symlink every skill directory (add/remove names to taste)
for s in ~/.local/share/Claude-OSINT/skills/*/; do
ln -sf "$s" ~/.claude/skills/"$(basename "$s")"
done
cd ~/.local/share/Claude-OSINT
./scripts/sync-skill-content.sh # one-time
Then git -C ~/.local/share/Claude-OSINT pull && ./scripts/sync-skill-content.sh periodically.
Start a new Claude Code session and type:
What ports should I probe to find Swagger or OpenAPI specs on a webapp?
Claude should pull the 28-path Swagger wordlist from the offensive-osint skill. If it doesn't, see troubleshooting below.
SKILL.md from each skill you want. At minimum the core pair — skills/osint-methodology/SKILL.md and skills/offensive-osint/SKILL.md — plus any of the six org-grade depth skills (org-attack-surface, email-domain-security, exposure-risk-quantification, continuous-exposure-monitoring, cloud-saas-exposure, identity-provider-recon) relevant to your engagement.tests/smoke-test-prompts.md for self-test reference.In any conversation within that Project, the skills are available as system knowledge.
Attach the skill content as part of the system prompt:
from anthropic import Anthropic
client = Anthropic()
with open("skills/osint-methodology/SKILL.md") as f:
methodology = f.read()
with open("skills/offensive-osint/SKILL.md") as f:
arsenal = f.read()
system_prompt = f"""You are an OSINT recon assistant for authorized red-team engagements.
You have access to the skills below and should reference them whenever relevant:
=== SKILL: osint-methodology ===
{methodology}
=== SKILL: offensive-osint ===
{arsenal}
"""
response = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=4096,
system=system_prompt,
messages=[{"role": "user", "content": "Plan a 4-hour external recon on acme.com (in-scope BB)"}]
)
print(response.content[0].text)
The example attaches the core pair. Attach any of the eight SKILL.md files the same way — concatenate the org-grade depth skills (org-attack-surface, exposure-risk-quantification, identity-provider-recon, etc.) into the system prompt when the task calls for them. All eight together are ~10,000 lines and still fit a 200K-context model.
These platforms typically auto-discover skills in ~/.claude/skills/. Install via the Claude Code method above and they'll be available.
If you're building a custom agent with the SDK, attach SKILL.md content to your agent's system prompt as shown in the API method.
Most AI IDEs allow custom system-prompt injection. Use the API method above as a template.
~/.claude/skills/<skill-name>/SKILL.md (not ~/.claude/skills/<skill-name>.md).--- and ends with ---).The skill's triggers: list controls auto-activation. If your prompt's wording isn't in the list, Claude may not pull the skill.
triggers: list.By default we ship structured-outline SKILL.md files (small, fast to load). To get full inline content:
cd <repo>
./scripts/sync-skill-content.sh
This populates skills/*/SKILL.md with the full content from docs/full-skills/*.SKILL.full.md.
All 8 skills together are ~10,000 lines / ~320 KB (the core pair alone is ~5,500 / ~150 KB). This fits comfortably in modern Claude context windows (200K+). If you're using an older model with smaller context:
Edit skills/<skill-name>/SKILL.md directly. Both files are plain Markdown. You can comment out sections you don't need or split them into multiple smaller skills.
Each SKILL.md declares version: in the YAML frontmatter. Current: osint-methodology 2.3, offensive-osint 2.2, and the six org-grade depth skills 1.0. Check via:
grep "^version:" skills/*/SKILL.md
# Remove every installed skill
rm -rf ~/.claude/skills/{osint-methodology,offensive-osint,org-attack-surface,email-domain-security,exposure-risk-quantification,continuous-exposure-monitoring,cloud-saas-exposure,identity-provider-recon}
Or remove the symlinks if you used method 2 above.
# Install all 8 skills (one-time, after clone)
git clone https://github.com/elementalsouls/Claude-OSINT.git
cd Claude-OSINT
chmod +x ./scripts/sync-skill-content.sh
./scripts/sync-skill-content.sh
mkdir -p ~/.claude/skills
cp -r skills/* ~/.claude/skills/
ls ~/.claude/skills/
Then, in any Claude Code session, ask an OSINT question — the skills auto-load and each triggers on its own relevant phrases. Install only the core pair (osint-methodology + offensive-osint) if you want the recon backbone without the org-grade depth skills.
# Point Claude at a single skill before starting your session
cat skills/offensive-osint/SKILL.md | claude --system-file -
Paste the contents of any SKILL.md into a Project's system prompt or prepend it to your conversation. Both files are plain Markdown — also usable as a personal cheat-sheet without Claude.
Then run powershell -ExecutionPolicy Bypass -File .\setup.ps1. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: winget install Git.Git
git clone https://github.com/elementalsouls/Claude-OSINT.git cd Claude-OSINT
Run these in Git Bash (installed with Git) or WSL — not PowerShell. Do the README instructions above first.
chmod +x ./scripts/sync-skill-content.sh ./scripts/sync-skill-content.sh mkdir -p ~/.claude/skills cp -r skills/* ~/.claude/skills/ ls ~/.claude/skills/ cat skills/offensive-osint/SKILL.md | claude --system-file -
The steps run shell scripts (.sh). Use Git Bash (winget install Git.Git) or WSL2 (wsl --install).
No reports for Windows yet.
GitManual AI Agent reads the 6 key files and writes a step-by-step guide for Windows. Once written, it's saved for everyone.