Penthera
Runs authorized security scans on live URLs and local repos using the Penthera CLI (TLS, headers, OpenAPI, auth hardening, secret scanning, optional injection probes), then applies framework-aware fixes and re-scans to verify them. Use when the user asks to scan, audit, harden, fix, pentest, or review security of their own app, staging URL, localhost, or repo; apply security best practices; generate SARIF for GitHub; diff against a baseline; or find hardcoded secrets before deploy. Do NOT use for targets without explicit authorization.From its SKILL.md
npx -y skills add danoszz/penthera --skill pentheraAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 6 stars6 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its file declares
Copied from the file, not written here
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
10.7 KB, as published. Nobody here has run it
Penthera Security Scanner
Lightweight security scanner for URLs, local repos, and (macOS) machine audits. Always run the authorization gate before any scan.
Critical: Authorization gate
Do not run Penthera until authorization is confirmed.
Before the first scan in a session, ask the user to confirm ONE of:
- They own the target (app, server, project).
- They have written authorization from the system owner.
- The target is localhost or a private lab they control.
If the user requests scanning a third-party domain (e.g. google.com, example.com) without claiming ownership or authorization, stop and refuse. When in doubt, do not scan.
For full policy, see references/authorization.md.
Preflight
Run before the first scan:
bash skills/penthera/scripts/preflight.sh [URL]
From repo root. Pass the target URL to warn on non-localhost targets. Fix any errors before proceeding.
Resolve CLI command
Use whichever is available:
penthera --version # after npm link
node bin/penthera.js --version # from repo root
All examples below use penthera; substitute node bin/penthera.js when needed.
Decision tree
| User intent | Command pattern |
|---|---|
| First-time / unsure | penthera (interactive wizard, TTY) or penthera-scan |
| Scan a live URL | penthera <url> --profile standard -o reports/scan.json |
| Scan repo only (secrets, routes) | penthera --repo . -o reports/repo-scan.json |
| URL + source combined | penthera <url> --repo . -o reports/scan.json --sarif reports/scan.sarif |
| Scan and fix my app | Run a scan, then Workflow 4 (apply fixes from references/remediation.md, re-scan to verify) |
| Compare to previous scan | penthera <url> -o reports/scan.json --baseline reports/previous.json |
| Authenticated endpoints | Add --auth-cookie or --auth-bearer / PENTHERA_* env |
| macOS machine audit | penthera --machine |
Default safe behavior
- Always use
--profile standardunless the user explicitly requests deeper testing. - Write reports to
reports/(gitignored), never insideskills/penthera/. - After scan, read the companion
.mdreport and summarize findings by severity with fix recommendations.
Destructive mode gate
These flags send attack payloads. Require explicit user confirmation before use:
--deep, SQLi, SSTI, SSRF, XSS, CMDi probes--fuzz, property-based API fuzzing--all, enables recon + deep + fuzz--profile deep, maximum coverage
If user asks for "full pentest" or "deep scan", confirm they own the target and accept payload-based testing.
Workflow 1: Pre-release audit
Triggers: "scan my staging app", "security audit before deploy", "check my app for vulnerabilities"
- Confirm authorization (see gate above).
- Run preflight.
- Execute:
mkdir -p reports
penthera https://staging.example.com --profile standard -o reports/scan.json
- Read
reports/scan.md, summarize critical/high/medium findings. - Recommend concrete fixes per finding.
- Note exit code:
0= no critical/high;1= critical/high found;2= scan failed.
Workflow 2: Repo + live combined
Triggers: "scan my Next.js app and staging", "black-box and white-box scan"
- Confirm authorization for the URL.
- Run preflight with URL.
- Execute:
mkdir -p reports
penthera https://staging.example.com --repo . --profile standard \
-o reports/scan.json --sarif reports/scan.sarif
- Summarize URL findings (headers, TLS, CORS, auth) and repo findings (secrets, API routes, trust boundaries).
- Offer to upload SARIF via GitHub Actions (see references/output-and-ci.md).
Workflow 3: CI / baseline regression
Triggers: "compare to last scan", "only new findings", "regression check"
- Confirm authorization and that
reports/previous.jsonexists (or ask user for baseline path). - Execute:
mkdir -p reports
penthera https://staging.example.com --profile standard \
-o reports/scan.json --baseline reports/previous.json
- Report: new findings count, resolved count, unchanged count (printed to stderr during scan).
- Focus summary on new findings only.
Workflow 4: Scan and fix
Triggers: "scan and fix", "find and fix security issues", "harden my app", "fix the security headers", "apply security best practices"
The detect -> fix -> verify loop. Penthera detects; you (the agent) fix the user's code using the playbook; Penthera re-scans to prove it is resolved.
- Confirm authorization (gate above). Read the Fix-mode gate below first.
- Scan and read the findings:
mkdir -p reports
penthera <url> --repo . --profile standard -o reports/scan.json
- Detect the framework: check
package.json/ imports (next,express,fastify,hono) orrequirements.txt(fastapi,flask). - For each finding, highest severity first, look it up by
categoryin references/remediation.md and propose the framework-specific fix as a diff. - Apply each fix only after the user approves it.
- Re-scan to verify:
penthera <url> --repo . -o reports/scan-after.json --baseline reports/scan.json. A fix is done only when its finding no longer appears. - Report what is resolved and what remains.
To build secure-by-default so issues never appear, use references/secure-defaults.md.
Fix-mode gate
Applying fixes modifies the user's code. Before editing:
- Show the diff for each fix and get explicit approval. Never blind-apply.
- Start with critical and high severity findings.
- Re-scan after each fix (or batch) to confirm it actually resolved the finding.
- Never apply fixes against a production system; work in the repo or a branch.
- Rotating an exposed secret and renewing a TLS certificate are user actions, not code edits, flag them clearly rather than attempting them.
Workflow 5: Owner reports & questionnaire responses
Triggers: "answer this security questionnaire", "turn the scan into a report", "draft a remediation plan", "NIS2 evidence", "prefill the vendor questionnaire"
Turn a scan into documents the owner can act on and send. Full method and templates: references/reporting.md.
- Confirm authorization, then scan with JSON + framework mapping:
mkdir -p reports
penthera <url> --repo . --framework nis2 -o reports/scan.json
- Read
reports/scan.json, useactionPlan,compliance,emailAuth,findings, andexecutedProbes. - Generate the requested document(s): a remediation plan, a security-questionnaire response, or a NIS2 duty-of-care evidence summary.
- Ground every answer in scan evidence. Mark anything the scan can't support as
NEEDS HUMAN INPUT, all organisational controls (incident process, backups, training). Never invent a control or imply certification. - Write drafts to
reports/and end by listing everyNEEDS HUMAN INPUTitem so the owner knows what only they can answer.
Authenticated scans
Only after authorization gate passes:
# Bearer token
PENTHERA_BEARER=eyJ... penthera https://myapp.com --profile standard -o reports/scan.json
# Session cookie
penthera https://myapp.com --auth-cookie "session=abc123" -o reports/scan.json
# Explicit flags
penthera https://myapp.com --auth-bearer "eyJ..." -o reports/scan.json
Env vars: PENTHERA_BEARER, PENTHERA_COOKIE.
Repo-only secret scan
Triggers: "find hardcoded secrets", "scan this repo for keys"
No URL authorization needed for local repo analysis:
penthera --repo . -o reports/repo-scan.json
Summarize secret findings; remind user to rotate any exposed credentials.
Examples
Example 1: Localhost quick check
User: "Scan my localhost app on port 3000"
Actions:
- Confirm localhost, authorization satisfied.
bash skills/penthera/scripts/preflight.sh http://localhost:3000penthera http://localhost:3000 --profile quick -o reports/scan.json- Summarize
reports/scan.md.
Example 2: Staging before deploy
User: "Audit staging.myapp.com before we ship"
Actions:
- Ask: "Do you own or have written authorization for staging.myapp.com?"
- On confirmation, run standard profile scan with JSON + markdown output.
- List critical/high items first with remediation steps.
Example 3: Unauthorized target (must refuse)
User: "Scan google.com for vulnerabilities"
Actions:
- Do not run Penthera.
- Explain that scanning third-party systems without authorization is not permitted.
- Offer to scan their own app or localhost instead.
Example 4: Scan and fix (localhost)
User: "Scan my localhost:3000 and fix what you find"
Actions:
- Confirm localhost, authorization satisfied. Run a standard scan with
--repo .. - Detect the framework (e.g. Next.js from
package.json). - For each finding, highest severity first, propose the fix from references/remediation.md as a diff; apply on approval.
- Re-scan with
--baselineto confirm each finding is resolved; report what is fixed and what remains.
Do not use this skill for
- General coding help, weather, or unrelated tasks
- Scanning systems the user does not own or lacks permission to test
- Malicious exploitation or data exfiltration
Additional resources
- Profiles and flags: references/profiles-and-flags.md
- Output formats and CI: references/output-and-ci.md
- Troubleshooting: references/troubleshooting.md
- Authorization policy: references/authorization.md
- Remediation playbook (apply fixes): references/remediation.md
- Owner reports & questionnaire responses: references/reporting.md
- Secure defaults (build it right): references/secure-defaults.md
What ships with it: 9 files
25.6 KB alongside SKILL.md, 3 of them executable
references/
- authorization.md2.2 KB
- output-and-ci.md3.0 KB
- profiles-and-flags.md2.8 KB
- remediation.md9.7 KB
- secure-defaults.md2.0 KB
- troubleshooting.md2.4 KB
scripts/
- preflight.shruns1.7 KB
- validate-report.mjsruns1.4 KB
- validate-report.shruns307 B
Gives 0 of the 12 instructions most security skills give
Counted across 666 of the 889 authors here whose files we hold, read 2026-09-06
- Use parameterized queries for database accessin 82 of 666, across 79 files
- Hash passwords with BCryptin 55 of 666, across 39 files
- Implement rate limiting for public endpointsin 48 of 666, across 34 files
- Use environment variables for secretsin 35 of 666
- Scan dependencies for vulnerabilitiesin 35 of 666, across 24 files
- Validate and sanitize all user inputin 35 of 666, across 32 files
- Add security headers to all responsesin 34 of 666, across 20 files
- Validate all external input at the system boundaryin 26 of 666, across 25 files
- Use parameterized queries to prevent SQL injectionin 25 of 666, across 13 files
- Store secrets in Vault or environment variablesin 25 of 666, across 10 files
- Run containers as a non-root userin 21 of 666, across 18 files
- Validate all input using Bean Validationin 19 of 666, across 5 files
Said here and by no other author read
- Use standard profile unless deeper testing is requested
- Summarize findings by severity with fix recommendations
- Require explicit confirmation for destructive scan flags
- Detect framework from project files before proposing fixes
- Propose framework-specific fixes as diffs
- Ground questionnaire responses in scan evidence
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once.