pentest-engagement-planner

Define legal scope, rules of engagement, and authorization artifacts for downstream pentest execution.

SKILL.md

GitHub

Pentest Engagement Planner

Stage

  • PTES: 1 - Pre-Engagement
  • MITRE: N/A

Objective

Generate canonical scope.json, engagement brief, and statement of work templates.

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

python skills/pentest-engagement-planner/scripts/engagement_planner.py --scope scope.json --target <target> --input <path> --output <path> --format json --dry-run

Outputs

  • scope.json
  • engagement-brief.md
  • statement-of-work-template.md

References

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

Legal and Ethical Notice

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