# prohao42/aimy-skill architecture

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

- Interactive diagram: https://gitdiagram.com/prohao42/aimy-skill
- Repository: https://github.com/prohao42/aimy-skill

## Overview

aimy-skill is an AI-agent-oriented penetration-testing toolkit with a CLI and an automated scan path. Its documented workflow moves from reconnaissance through vulnerability detection and validation to exploit chaining and reporting. The README also describes authentication, business-logic, WAF-evasion, and weaponization capabilities, which are represented as distinct branches. Some internal wiring is supported only by the README or SOURCE INDEX; unsampled modules are not treated as inspected, and uncertain links are omitted.

Main entry points: [`tools/orchestrator.py`](https://github.com/prohao42/aimy-skill/blob/main/tools/orchestrator.py) (Scan orchestrator), [`tools/orchestrator_engine/detect/detect_engine.py`](https://github.com/prohao42/aimy-skill/blob/main/tools/orchestrator_engine/detect/detect_engine.py) (Vulnerability checks), [`tools/sql_injection.py`](https://github.com/prohao42/aimy-skill/blob/main/tools/sql_injection.py) (SQL injection), [`main.py`](https://github.com/prohao42/aimy-skill/blob/main/main.py) (CLI commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and orchestration"]
  node_cli["CLI commands<br/>[main.py]"]
  node_orchestrator["Scan orchestrator<br/>[orchestrator.py]"]
end

subgraph group_discovery["Reconnaissance"]
  node_recon["Recon engine<br/>[recon_engine.py]"]
  node_subdomain["Subdomain enumeration<br/>[subdomain.py]"]
  node_attack_surface["Attack surface<br/>[attack_surface.py]"]
  node_crawler["Web crawling<br/>[crawler.py]"]
end

subgraph group_assessment["Assessment and validation"]
  node_detect["Vulnerability checks<br/>[detect_engine.py]"]
  node_sql["SQL injection<br/>[sql_injection.py]"]
  node_auth["Auth bypass<br/>[auth_bypass.py]"]
  node_business["Business logic checks"]
  node_waf["WAF evasion<br/>[waf_bypass.py]"]
  node_verify["Finding verification"]
end

subgraph group_operations["Exploitation and reporting"]
  node_chain["Exploit chaining<br/>[chain_engine.py]"]
  node_weaponize["SQL weaponization<br/>[sqli_weaponizer.py]"]
  node_kali["Kali integrations<br/>[kali_toolset.py]"]
  node_report["Reports<br/>[reporter.py]"]
end

subgraph group_foundation["Shared runtime"]
  node_payload["Payload generation<br/>[payload_engine.py]"]
  node_http["HTTP client<br/>[http_client.py]"]
  node_registry["Tool registry<br/>[tool_registry.py]"]
  node_settings["Runtime settings<br/>[settings.py]"]
end

node_agent(("AI agent"))
node_target(("Authorized target"))

node_agent -->|"invokes"| node_cli
node_cli -->|"starts scans"| node_orchestrator
node_orchestrator -->|"runs reconnaissance"| node_recon
node_recon -->|"enumerates hosts"| node_subdomain
node_orchestrator -->|"maps surface"| node_attack_surface
node_orchestrator -->|"crawls pages"| node_crawler
node_orchestrator -->|"runs detection"| node_detect
node_detect -->|"checks injection"| node_sql
node_orchestrator -->|"checks authentication"| node_auth
node_orchestrator -->|"checks business logic"| node_business
node_sql -->|"sends requests"| node_http
node_sql -->|"uses payloads"| node_payload
node_sql -->|"uses evasion"| node_waf
node_orchestrator -->|"validates findings"| node_verify
node_orchestrator -->|"runs exploit chains"| node_chain
node_chain -->|"uses SQL extraction"| node_weaponize
node_cli -->|"offers Kali commands"| node_kali
node_orchestrator -->|"produces report"| node_report
node_orchestrator -->|"uses configuration"| node_settings
node_detect -->|"resolves tools"| node_registry
node_recon -->|"probes"| node_target
node_detect -->|"tests"| node_target

click node_cli "https://github.com/prohao42/aimy-skill/blob/main/main.py"
click node_orchestrator "https://github.com/prohao42/aimy-skill/blob/main/tools/orchestrator.py"
click node_recon "https://github.com/prohao42/aimy-skill/blob/main/tools/orchestrator_engine/recon/recon_engine.py"
click node_subdomain "https://github.com/prohao42/aimy-skill/blob/main/tools/recon/subdomain.py"
click node_attack_surface "https://github.com/prohao42/aimy-skill/blob/main/tools/attack_surface.py"
click node_crawler "https://github.com/prohao42/aimy-skill/blob/main/tools/crawler.py"
click node_detect "https://github.com/prohao42/aimy-skill/blob/main/tools/orchestrator_engine/detect/detect_engine.py"
click node_sql "https://github.com/prohao42/aimy-skill/blob/main/tools/sql_injection.py"
click node_auth "https://github.com/prohao42/aimy-skill/blob/main/tools/auth_bypass.py"
click node_business "https://github.com/prohao42/aimy-skill/blob/main/tools/biz_logic_scanner.py"
click node_waf "https://github.com/prohao42/aimy-skill/blob/main/tools/waf_bypass.py"
click node_verify "https://github.com/prohao42/aimy-skill/blob/main/tools/verification_oracle.py"
click node_payload "https://github.com/prohao42/aimy-skill/blob/main/tools/payload_engine.py"
click node_http "https://github.com/prohao42/aimy-skill/blob/main/tools/http_client.py"
click node_registry "https://github.com/prohao42/aimy-skill/blob/main/tools/tool_registry.py"
click node_settings "https://github.com/prohao42/aimy-skill/blob/main/tools/settings.py"
click node_chain "https://github.com/prohao42/aimy-skill/blob/main/tools/chain_engine.py"
click node_weaponize "https://github.com/prohao42/aimy-skill/blob/main/tools/sqli_weaponizer.py"
click node_kali "https://github.com/prohao42/aimy-skill/blob/main/tools/kali_toolset.py"
click node_report "https://github.com/prohao42/aimy-skill/blob/main/tools/reporter.py"

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_cli,node_orchestrator toneBlue
class node_recon,node_subdomain,node_attack_surface,node_crawler toneAmber
class node_detect,node_sql,node_auth,node_business,node_waf,node_verify toneMint
class node_chain,node_weaponize,node_kali,node_report toneRose
class node_payload,node_http,node_registry,node_settings,node_agent,node_target toneIndigo
```

## Components

### Entry and orchestration

- [CLI commands](https://github.com/prohao42/aimy-skill/blob/main/main.py): `main.py`
- [Scan orchestrator](https://github.com/prohao42/aimy-skill/blob/main/tools/orchestrator.py): `tools/orchestrator.py`

### Reconnaissance

- [Recon engine](https://github.com/prohao42/aimy-skill/blob/main/tools/orchestrator_engine/recon/recon_engine.py): `tools/orchestrator_engine/recon/recon_engine.py`
- [Subdomain enumeration](https://github.com/prohao42/aimy-skill/blob/main/tools/recon/subdomain.py): `tools/recon/subdomain.py`
- [Attack surface](https://github.com/prohao42/aimy-skill/blob/main/tools/attack_surface.py): `tools/attack_surface.py`
- [Web crawling](https://github.com/prohao42/aimy-skill/blob/main/tools/crawler.py): `tools/crawler.py`

### Assessment and validation

- [Vulnerability checks](https://github.com/prohao42/aimy-skill/blob/main/tools/orchestrator_engine/detect/detect_engine.py): `tools/orchestrator_engine/detect/detect_engine.py`
- [SQL injection](https://github.com/prohao42/aimy-skill/blob/main/tools/sql_injection.py): `tools/sql_injection.py`
- [Auth bypass](https://github.com/prohao42/aimy-skill/blob/main/tools/auth_bypass.py): `tools/auth_bypass.py`
- [Business logic checks](https://github.com/prohao42/aimy-skill/blob/main/tools/biz_logic_scanner.py): `tools/biz_logic_scanner.py`
- [WAF evasion](https://github.com/prohao42/aimy-skill/blob/main/tools/waf_bypass.py): `tools/waf_bypass.py`
- [Finding verification](https://github.com/prohao42/aimy-skill/blob/main/tools/verification_oracle.py): `tools/verification_oracle.py`

### Exploitation and reporting

- [Exploit chaining](https://github.com/prohao42/aimy-skill/blob/main/tools/chain_engine.py): `tools/chain_engine.py`
- [SQL weaponization](https://github.com/prohao42/aimy-skill/blob/main/tools/sqli_weaponizer.py): `tools/sqli_weaponizer.py`
- [Kali integrations](https://github.com/prohao42/aimy-skill/blob/main/tools/kali_toolset.py): `tools/kali_toolset.py`
- [Reports](https://github.com/prohao42/aimy-skill/blob/main/tools/reporter.py): `tools/reporter.py`

### Shared runtime

- [Payload generation](https://github.com/prohao42/aimy-skill/blob/main/tools/payload_engine.py): `tools/payload_engine.py`
- [HTTP client](https://github.com/prohao42/aimy-skill/blob/main/tools/http_client.py): `tools/http_client.py`
- [Tool registry](https://github.com/prohao42/aimy-skill/blob/main/tools/tool_registry.py): `tools/tool_registry.py`
- [Runtime settings](https://github.com/prohao42/aimy-skill/blob/main/tools/settings.py): `tools/settings.py`

### Other components

- **AI agent**
- **Authorized target**

## Connections

- AI agent → CLI commands: invokes (evidence: `README.md`)
- CLI commands → Scan orchestrator: starts scans (evidence: `README.md`)
- Scan orchestrator → Recon engine: runs reconnaissance (evidence: `README.md`)
- Recon engine → Subdomain enumeration: enumerates hosts (evidence: `tools/orchestrator_engine/recon/recon_engine.py`)
- Scan orchestrator → Attack surface: maps surface (evidence: `tools/orchestrator.py`)
- Scan orchestrator → Web crawling: crawls pages (evidence: `README.md`)
- Scan orchestrator → Vulnerability checks: runs detection (evidence: `README.md`)
- Vulnerability checks → SQL injection: checks injection (evidence: `README.md`)
- Scan orchestrator → Auth bypass: checks authentication (evidence: `README.md`)
- Scan orchestrator → Business logic checks: checks business logic (evidence: `README.md`)
- SQL injection → HTTP client: sends requests (evidence: `tools/sql_injection.py`)
- SQL injection → Payload generation: uses payloads (evidence: `tools/sql_injection.py`)
- SQL injection → WAF evasion: uses evasion (evidence: `tools/sql_injection.py`)
- Scan orchestrator → Finding verification: validates findings (evidence: `README.md`)
- Scan orchestrator → Exploit chaining: runs exploit chains (evidence: `README.md`)
- Exploit chaining → SQL weaponization: uses SQL extraction (evidence: `tools/chain_engine.py`)
- CLI commands → Kali integrations: offers Kali commands (evidence: `README.md`)
- Scan orchestrator → Reports: produces report (evidence: `README.md`)
- Scan orchestrator → Runtime settings: uses configuration (evidence: `tools/orchestrator.py`)
- Vulnerability checks → Tool registry: resolves tools (evidence: `tools/orchestrator_engine/detect/detect_engine.py`)
- Recon engine → Authorized target: probes (evidence: `README.md`)
- Vulnerability checks → Authorized target: tests (evidence: `README.md`)
