pyspector-security-audit

Runs a full Python codebase security audit using the PySpector Rust-core SAST scanner.

151|40|Updated Aug 9, 2023
One-click install
npx skills add https://github.com/ParzivalHack/PySpector --skill pyspector-security-audit-parzivalhack
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pyspector-security-audit
Source: https://github.com/ParzivalHack/PySpector
Command: npx skills add https://github.com/ParzivalHack/PySpector --skill pyspector-security-audit-parzivalhack

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyspector.

What problem does it solve? Manually auditing a Python codebase for vulnerabilities is slow and error-prone, and raw SAST scanner output is noisy with false positives. This Skill automates the entire audit: it installs and verifies PySpector (including its required Rust toolchain), selects the right scan flags based on what the codebase actually contains, runs the scan, and statically re-verifies each finding against the real source before reporting only confirmed issues. ## Core Features & Use Cases - End-to-end audit workflow: Handles installation, Rust toolchain setup, CLI flag discovery via live --help output, codebase recon, scanning, verification, and reporting. - Context-aware flag selection: Detects LLM/AI library usage (openai, langchain, etc.) to enable AI-specific rules, and assesses dependency pinning to decide on supply-chain CVE checks against OSV.dev. - False-positive filtering: Re-reads flagged files and traces taint paths from source to sink, classifying findings as confirmed true positives, false positives, or needing human judgement. - Use Case: Point the agent at a FastAPI project and ask for a security audit; it installs PySpector, scans with the appropriate rulesets, verifies each finding against the code, and delivers an HTML report plus a summary of confirmed vulnerabilities with file, line, and exploitability reasoning. ## Quick Start Ask the agent to run a security audit of your Python project with PySpector and report only verified vulnerabilities.

Frequently Asked Questions about pyspector-security-audit

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

FAQPage Schema
How do I run a security audit on a Python codebase?▼

Invoke this Skill and point it at your project directory or a public repository URL. It installs PySpector, scans the code with appropriate rulesets, verifies findings against the source, and produces a report of confirmed vulnerabilities.

What is PySpector and how does it scan Python code?▼

PySpector is a SAST framework with a Rust analysis core and Python CLI. It combines regex, AST, and graph-based taint engines to track untrusted data from sources to sinks across function boundaries in Python code.

Does PySpector require Rust to be installed?▼

Yes, PySpector's analysis core is written in Rust, so rustc and cargo must be present. The Skill checks for the toolchain and installs it via rustup if missing before proceeding with the scan.

Can PySpector scan private Git repositories?▼

No, the --url option only works with public GitHub and GitLab repositories. For private repos, provide a local clone or uploaded copy of the code and scan it as a local path instead.

How are false positives handled in the audit report?▼

Every finding at MEDIUM severity or above is re-verified by reading the flagged file and tracing the claimed taint path. Only confirmed true positives and items needing human judgement appear in the final report.

When should I use the AI or supply-chain scan flags?▼

Use the AI ruleset when the project imports LLM libraries like openai, langchain, or transformers. Use the supply-chain flag to check dependencies against known CVEs via OSV.dev, especially for projects with unpinned or outdated dependencies.