pentest-agent-scope

Parse and validate penetration testing scope files against engagement rules.

Updated Jul 30, 2026
One-click install
npx skills add https://github.com/salmanabdurrahman/pi-pentest-agent --skill pentest-agent-scope
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pentest-agent-scope
Source: https://github.com/salmanabdurrahman/pi-pentest-agent/tree/main/skills/pentest-agent-scope
Command: npx skills add https://github.com/salmanabdurrahman/pi-pentest-agent --skill pentest-agent-scope

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill prevents unauthorized security testing by providing a rigorous, automated framework for parsing scope files and validating targets against defined rules before any active assessment begins.

Core Features & Use Cases

  • Deterministic Validation: Automatically parses JSON or plain-text scope files to identify in-scope targets, out-of-scope exclusions, and prohibited testing methods.
  • Policy Enforcement: Ensures all planned security activities comply with rate limits, testing windows, and authorization requirements.
  • Use Case: Before starting a penetration test, use this skill to verify that your target list and planned methods are strictly within the bounds of your engagement's rules of engagement.

Quick Start

Use the pentest-agent-scope skill to parse the scope.json file and validate the target URL against the defined rules.

Frequently Asked Questions about pentest-agent-scope

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate penetration testing scope before starting an assessment?

To validate penetration testing scope, you can parse JSON or plain-text scope files to identify in-scope targets, out-of-scope exclusions, and prohibited testing methods before any active assessment begins. This ensures strict adherence to engagement rules.

What is passive pre-execution validation for security targets?

Passive pre-execution validation for security targets is the process of checking planned testing activities against defined rate limits, testing windows, and authorization requirements without sending active traffic to the target.

How do I enforce compliance with rate limits and testing windows during a pentest?

You enforce compliance with rate limits and testing windows by applying automated policy enforcement to your parsed scope definitions, ensuring all planned security activities comply with the engagement's rules of engagement.

Can I parse a plain-text scope file to identify out-of-scope exclusions?

Yes, you can parse plain-text scope files to identify out-of-scope exclusions. The validation framework deterministically extracts in-scope targets, out-of-scope exclusions, and prohibited testing methods from the provided text.

Does scope validation prevent unauthorized security testing?

Scope validation prevents unauthorized security testing by providing a rigorous, automated framework that checks targets and planned methods against defined rules of engagement before any active assessment execution begins.

What format should a scope.json file follow for target validation?

A scope.json file for target validation should define in-scope targets, out-of-scope exclusions, rate limits, testing windows, and method-policy definitions to satisfy the parsing and validation requirements of the framework.