frangelbarrera/osint-agent-skills

> A knowledge base that turns any autonomous AI agent into a senior OSINT analyst.
## What is this?
osint-agent-skills is not an agent. It is not a script. It is not a SaaS.
It is a structured knowledge base — a curated set of methodologies, tool registries, pivot playbooks, ethics rules, and report templates — that any autonomous AI agent can consume to instantly adopt the operating discipline of a senior open-source intelligence analyst.
If you point Claude Code, Cursor, Ollama, OpenCode, AutoClaw, or any other agent framework at this repository, the agent will:
1. Load system-prompt.md and adopt the OSINT Agent Skills persona.
2. Consult knowledge/methodologies/ to plan its investigation.
3. Use tools/free-tools.yaml and tools/apis.yaml to execute lookups.
4. Follow knowledge/pivot-playbooks/ to chain findings into networks.
5. Generate a report using templates/reports/intelligence-report.md.
6. Respect ethics/legal-frameworks.md throughout — never suggesting illegal techniques, never fabricating findings.
This repository is agent-agnostic. It works the same way regardless of which LLM or agent framework you use.
## Why does this exist?
Modern LLMs are powerful OSINT tools — but only when given the right discipline. Without an explicit operating framework, agents hallucinate IPs, skip source citations, blur the line between OSINT and intrusion, and produce reports that look authoritative but cannot be audited.
osint-agent-skills solves this by codifying the operating rules that a senior analyst would otherwise enforce through peer review. The system prompt is brutally explicit about anti-hallucination. The pivot playbooks tell the agent exactly what to do when it finds an email, a domain, a phone number, a cryptocurrency wallet, or a photograph. The ethics framework defines what is in-bounds by jurisdiction. The report templates enforce source citation and confidence labeling.
The result: when you ask an agent that has consumed this knowledge base investigate the domain example.com", you get a structured intelligence report with cited sources, performed pivots, and explicit limitations — not a stream of plausible-sounding prose.
## Who is this for?
Security researchers who want their agent to do OSINT legwork with the rigor they would apply themselves.
Threat intelligence analysts who want to automate the repetitive collection phase and focus on analysis.
Journalists investigating disinformation, fraud, or corruption — especially those using Bellingcat-style methodology.
Due diligence teams who need to background companies and individuals from public sources.
OSINT educators who want a reference framework for teaching methodology.
Anyone who has watched an LLM investigate something and produce confidently wrong results.
## Quick start
bash
git clone https://github.com/frangelbarrera/osint-agent-skills
cd osint-agent-skills
Then point your agent at the repository. Integration guides:
| Agent | Guide |
| Claude Code | integrations/claude-code.md |
| Cursor | integrations/cursor.md |
| Ollama (local) | integrations/ollama.md |
| OpenCode | integrations/opencode.md |
| AutoClaw | integrations/autoclaw.md |