# smixs/osint-skill architecture

> Architecture diagram of the GitHub repository smixs/osint-skill, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/smixs/osint-skill
- Repository: https://github.com/smixs/osint-skill

## Overview

OSINT Skill is an agent-readable research workflow that turns a person’s name or handle into a confidence-scored dossier. The documented path proceeds from tool checks and seed searches through internal intelligence, platform extraction, cross-referencing, psychoprofile, completeness checks, and dossier output; research can escalate from free search to paid and social-data services. The README describes orchestration and phase relationships, while sampled runner code confirms Apify execution and dataset retrieval. Most workflow logic lives in the unsampled skill instructions, so those links reflect README documentation rather than inspected implementation.

Main entry points: [`osint/SKILL.md`](https://github.com/smixs/osint-skill/blob/main/osint/SKILL.md) (Skill orchestration), [`osint/scripts/run_actor.js`](https://github.com/smixs/osint-skill/blob/main/osint/scripts/run_actor.js) (Apify runner), [`osint/scripts/first-volley.sh`](https://github.com/smixs/osint-skill/blob/main/osint/scripts/first-volley.sh) (Seed search), [`osint/references/platforms.md`](https://github.com/smixs/osint-skill/blob/main/osint/references/platforms.md) (Platform extraction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Research workflow"]
  node_skill["Skill orchestration<br/>[SKILL.md]"]
  node_diagnostics["Tool diagnostics<br/>[diagnose.sh]"]
  node_seed["Seed search<br/>[first-volley.sh]"]
  node_result_merge["Search merging<br/>[merge-volley.sh]"]
  node_internal["Internal intelligence<br/>[SKILL.md]"]
end

subgraph group_sources["Collection sources"]
  node_platforms["Platform extraction<br/>[platforms.md]"]
  node_actor_shortcuts["Apify shortcuts<br/>[apify.sh]"]
  node_actor_runner["Apify runner<br/>[run_actor.js]"]
  node_mcp_client["Bright Data MCP client<br/>[mcp-client.py]"]
  node_content["Content extraction"]
end

subgraph group_analysis["Analysis"]
  node_cross_reference["Fact verification<br/>[SKILL.md]"]
  node_psychoprofile["Psychoprofile<br/>[psychoprofile.md]"]
  node_completeness["Completeness scoring<br/>[SKILL.md]"]
end

subgraph group_report["Dossier output"]
  node_dossier["Dossier formatting"]
end

node_researcher(("Researcher"))
node_search_services{{"Search APIs"}}
node_apify{{"Apify service"}}
node_brightdata{{"Bright Data MCP"}}
node_internal_records[("Telegram, email, vault")]

node_researcher -->|"requests research"| node_skill
node_skill -->|"checks tools"| node_diagnostics
node_skill -->|"starts search"| node_seed
node_seed -->|"queries engines"| node_search_services
node_skill -->|"merges results"| node_result_merge
node_skill -->|"checks first"| node_internal
node_internal -->|"searches records"| node_internal_records
node_skill -->|"guides extraction"| node_platforms
node_platforms -->|"uses actors"| node_actor_shortcuts
node_actor_shortcuts -->|"runs actor"| node_actor_runner
node_actor_runner -->|"starts and polls"| node_apify
node_actor_runner -->|"downloads dataset"| node_apify
node_skill -.->|"uses scraping"| node_mcp_client
node_mcp_client -->|"calls MCP tools"| node_brightdata
node_skill -->|"extracts content"| node_content
node_skill -->|"verifies facts"| node_cross_reference
node_skill -->|"analyzes content"| node_psychoprofile
node_skill -->|"checks coverage"| node_completeness
node_skill -->|"formats findings"| node_dossier

click node_skill "https://github.com/smixs/osint-skill/blob/main/osint/SKILL.md"
click node_diagnostics "https://github.com/smixs/osint-skill/blob/main/osint/scripts/diagnose.sh"
click node_seed "https://github.com/smixs/osint-skill/blob/main/osint/scripts/first-volley.sh"
click node_result_merge "https://github.com/smixs/osint-skill/blob/main/osint/scripts/merge-volley.sh"
click node_internal "https://github.com/smixs/osint-skill/blob/main/osint/SKILL.md"
click node_platforms "https://github.com/smixs/osint-skill/blob/main/osint/references/platforms.md"
click node_actor_shortcuts "https://github.com/smixs/osint-skill/blob/main/osint/scripts/apify.sh"
click node_actor_runner "https://github.com/smixs/osint-skill/blob/main/osint/scripts/run_actor.js"
click node_mcp_client "https://github.com/smixs/osint-skill/blob/main/osint/scripts/mcp-client.py"
click node_content "https://github.com/smixs/osint-skill/blob/main/osint/references/content-extraction.md"
click node_cross_reference "https://github.com/smixs/osint-skill/blob/main/osint/SKILL.md"
click node_psychoprofile "https://github.com/smixs/osint-skill/blob/main/osint/references/psychoprofile.md"
click node_completeness "https://github.com/smixs/osint-skill/blob/main/osint/SKILL.md"
click node_dossier "https://github.com/smixs/osint-skill/blob/main/osint/assets/dossier-template.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_skill,node_diagnostics,node_seed,node_result_merge,node_internal toneBlue
class node_platforms,node_actor_shortcuts,node_actor_runner,node_mcp_client,node_content,node_internal_records toneAmber
class node_cross_reference,node_psychoprofile,node_completeness,node_search_services,node_apify toneMint
class node_dossier toneRose
class node_researcher,node_brightdata toneIndigo
```

## Components

### Research workflow

- [Skill orchestration](https://github.com/smixs/osint-skill/blob/main/osint/SKILL.md): `osint/SKILL.md`
- [Tool diagnostics](https://github.com/smixs/osint-skill/blob/main/osint/scripts/diagnose.sh): `osint/scripts/diagnose.sh`
- [Seed search](https://github.com/smixs/osint-skill/blob/main/osint/scripts/first-volley.sh): `osint/scripts/first-volley.sh`
- [Search merging](https://github.com/smixs/osint-skill/blob/main/osint/scripts/merge-volley.sh): `osint/scripts/merge-volley.sh`
- [Internal intelligence](https://github.com/smixs/osint-skill/blob/main/osint/SKILL.md): `osint/SKILL.md`

### Collection sources

- [Platform extraction](https://github.com/smixs/osint-skill/blob/main/osint/references/platforms.md): `osint/references/platforms.md`
- [Apify shortcuts](https://github.com/smixs/osint-skill/blob/main/osint/scripts/apify.sh): `osint/scripts/apify.sh`
- [Apify runner](https://github.com/smixs/osint-skill/blob/main/osint/scripts/run_actor.js): `osint/scripts/run_actor.js`
- [Bright Data MCP client](https://github.com/smixs/osint-skill/blob/main/osint/scripts/mcp-client.py): `osint/scripts/mcp-client.py`
- [Content extraction](https://github.com/smixs/osint-skill/blob/main/osint/references/content-extraction.md): `osint/references/content-extraction.md`

### Analysis

- [Fact verification](https://github.com/smixs/osint-skill/blob/main/osint/SKILL.md): `osint/SKILL.md`
- [Psychoprofile](https://github.com/smixs/osint-skill/blob/main/osint/references/psychoprofile.md): `osint/references/psychoprofile.md`
- [Completeness scoring](https://github.com/smixs/osint-skill/blob/main/osint/SKILL.md): `osint/SKILL.md`

### Dossier output

- [Dossier formatting](https://github.com/smixs/osint-skill/blob/main/osint/assets/dossier-template.md): `osint/assets/dossier-template.md`

### Other components

- **Researcher**
- **Search APIs**
- **Apify service**
- **Bright Data MCP**
- **Telegram, email, vault**

## Connections

- Researcher → Skill orchestration: requests research (evidence: `README.md`)
- Skill orchestration → Tool diagnostics: checks tools (evidence: `README.md`)
- Skill orchestration → Seed search: starts search (evidence: `README.md`)
- Seed search → Search APIs: queries engines (evidence: `README.md`)
- Skill orchestration → Search merging: merges results (evidence: `README.md`)
- Skill orchestration → Internal intelligence: checks first (evidence: `README.md`)
- Internal intelligence → Telegram, email, vault: searches records (evidence: `README.md`)
- Skill orchestration → Platform extraction: guides extraction (evidence: `README.md`)
- Platform extraction → Apify shortcuts: uses actors (evidence: `README.md`)
- Apify shortcuts → Apify runner: runs actor (evidence: `README.md`)
- Apify runner → Apify service: starts and polls (evidence: `osint/scripts/run_actor.js`)
- Apify runner → Apify service: downloads dataset (evidence: `osint/scripts/run_actor.js`)
- Skill orchestration → Bright Data MCP client: uses scraping (evidence: `README.md`)
- Bright Data MCP client → Bright Data MCP: calls MCP tools (evidence: `README.md`)
- Skill orchestration → Content extraction: extracts content (evidence: `README.md`)
- Skill orchestration → Fact verification: verifies facts (evidence: `README.md`)
- Skill orchestration → Psychoprofile: analyzes content (evidence: `README.md`)
- Skill orchestration → Completeness scoring: checks coverage (evidence: `README.md`)
- Skill orchestration → Dossier formatting: formats findings (evidence: `README.md`)
