How prohao42/aimy-skill works
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: orchestrator.py Scan orchestrator · detect_engine.py Vulnerability checks · sql_injection.py SQL injection · main.py CLI commands
Components 22
Entry and orchestration
- CLI commands
main.py - Scan orchestrator
tools/orchestrator.py
Reconnaissance
- Recon engine
tools/orchestrator_engine/recon/recon_engine.py - Subdomain enumeration
tools/recon/subdomain.py - Attack surface
tools/attack_surface.py - Web crawling
tools/crawler.py
Assessment and validation
- Vulnerability checks
tools/orchestrator_engine/detect/detect_engine.py - SQL injection
tools/sql_injection.py - Auth bypass
tools/auth_bypass.py - Business logic checks
tools/biz_logic_scanner.py - WAF evasion
tools/waf_bypass.py - Finding verification
tools/verification_oracle.py
Exploitation and reporting
- Exploit chaining
tools/chain_engine.py - SQL weaponization
tools/sqli_weaponizer.py - Kali integrations
tools/kali_toolset.py - Reports
tools/reporter.py
Shared runtime
- Payload generation
tools/payload_engine.py - HTTP client
tools/http_client.py - Tool registry
tools/tool_registry.py - Runtime settings
tools/settings.py
Other components
- AI agent
- Authorized target
Connections 22
- AI agent → CLI commands: invokes
README.md - CLI commands → Scan orchestrator: starts scans
README.md - Scan orchestrator → Recon engine: runs reconnaissance
README.md - Recon engine → Subdomain enumeration: enumerates hosts
tools/orchestrator_engine/recon/recon_engine.py - Scan orchestrator → Attack surface: maps surface
tools/orchestrator.py - Scan orchestrator → Web crawling: crawls pages
README.md - Scan orchestrator → Vulnerability checks: runs detection
README.md - Vulnerability checks → SQL injection: checks injection
README.md - Scan orchestrator → Auth bypass: checks authentication
README.md - Scan orchestrator → Business logic checks: checks business logic
README.md - SQL injection → HTTP client: sends requests
tools/sql_injection.py - SQL injection → Payload generation: uses payloads
tools/sql_injection.py - SQL injection → WAF evasion: uses evasion
tools/sql_injection.py - Scan orchestrator → Finding verification: validates findings
README.md - Scan orchestrator → Exploit chaining: runs exploit chains
README.md - Exploit chaining → SQL weaponization: uses SQL extraction
tools/chain_engine.py - CLI commands → Kali integrations: offers Kali commands
README.md - Scan orchestrator → Reports: produces report
README.md - Scan orchestrator → Runtime settings: uses configuration
tools/orchestrator.py - Vulnerability checks → Tool registry: resolves tools
tools/orchestrator_engine/detect/detect_engine.py - Recon engine → Authorized target: probes
README.md - Vulnerability checks → Authorized target: tests
README.md