Pentest Network Scanner

---
name: pentest-network-scanner
description: Actively enumerate in-scope hosts and services, then produce normalized network mapping artifacts.
---

# Pentest Network Scanner

## Stage

- PTES: 2-3
- MITRE: TA0007 - Discovery

## Objective

Identify exposed network services and protocol-level attack surface.

## Required Workflow

1. Validate scope before any active action and reject out-of-scope targets.
2. Run only authorized checks aligned to PTES, OWASP WSTG, NIST SP 800-115, and MITRE ATT&CK.
3. Write findings in canonical finding_schema format with reproducible PoC notes.
4. Honor dry-run mode and require explicit --i-have-authorization for live execution.
5. Export deterministic artifacts for downstream skill consumption.

## Execution

```bash
python skills/pentest-network-scanner/scripts/network_scanner.py --scope scope.json --target <target> --input <path> --output <path> --format json --dry-run
```

## Outputs

- `open-ports.json`
- `services.json`
- `network-map.json`
- `screenshots/index.json`
- `network-scan-report.json`

## References

- `references/tools.md`
- `skills/autonomous-pentester/shared/scope_schema.json`
- `skills/autonomous-pentester/shared/finding_schema.json`

## Legal and Ethical Notice

```text
WARNING AUTHORIZED USE ONLY
This skill executes real security testing tools against live targets.
Use only with written authorization.

```