| name | security-quality-assess |
| description | Automated security vulnerability scanning for Python and JavaScript/TypeScript codebases. Detects OWASP Top 10 vulnerabilities, hardcoded secrets, injection risks, and known CVEs with actionable remediation guidance. |
Security Quality Assessment Skill
Comprehensive static security analysis that automatically scans codebases to detect vulnerabilities across OWASP Top 10 (2021) categories.
Use this skill to identify security vulnerabilities early in development, maintain security compliance, and receive actionable remediation guidance for detected issues.
Usage
/security-assess .
/security-assess /path/to/project
/security-assess . --output security-report.md
/security-assess . --skip-osv
/security-assess . --verbose
What This Skill Does
Performs comprehensive security analysis to answer:
- What security vulnerabilities exist in my codebase?
- Are there hardcoded secrets or credentials?
- Which dependencies have known CVEs?
- What's my overall security risk score?
- How do I fix the identified issues?
Detection Coverage
Covers OWASP Top 10 (2021) categories A01-A07: access control, cryptographic failures, injection, insecure design, misconfiguration, vulnerable components (CVEs), and authentication failures. Read references/detection-coverage.md for the full per-category list of detected patterns when you need to know exactly what is flagged.
Severity Levels
Findings are prioritized for action:
- CRITICAL - Immediate action required (hardcoded credentials, code injection, known CVEs with CVSS 9.0+)
- HIGH - Fix within 1 sprint (SQL injection, missing auth, weak crypto, CVSS 7.0-8.9)
- MEDIUM - Plan remediation (insecure configs, minor misconfigurations, CVSS 4.0-6.9)
- LOW - Nice to fix (code quality improvements, CVSS 0.1-3.9)
Exit Codes
The tool uses exit codes for CI/CD integration:
- 0 - Clean (no CRITICAL or HIGH findings)
- 1 - Issues found (CRITICAL or HIGH findings detected)
- 2 - Fatal error (analysis failed to complete)
Suppression System
Suppress false positives with an audit trail via .security-suppress.json (entries support expiration dates and approver fields). Read references/configuration.md for the file format, matching precedence, and expiration rules when suppressing findings.
Common Workflows
Pre-Commit Security Check
/security-assess . --output report.md
if [ $? -eq 0 ]; then
git commit -m "Feature complete"
else
echo "Security issues found - review report.md"
fi
CI/CD Integration
/security-assess . --verbose --output security-report.md
exit_code=$?
if [ $exit_code -eq 1 ]; then
echo "Security vulnerabilities block merge"
exit 1
fi
Fast Local Development Scan
/security-assess . --skip-osv --output quick-scan.md
Report Output
The markdown report includes:
- Executive Summary - Risk score, finding counts by severity
- Risk Breakdown - Visual distribution of findings
- OWASP Top 10 Coverage - Findings mapped to categories
- Detailed Findings - Each issue with:
- File path and line number
- Code snippet with context
- OWASP category and CWE reference
- Specific remediation guidance
- Suppressions Summary - Count of suppressed and expired suppressions
Limitations
Language Support:
- Currently supports Python (.py) and JavaScript/TypeScript (.js, .ts, .jsx, .tsx)
- More languages planned for future releases
False Positives:
- Static analysis may flag legitimate code patterns
- Use suppression system to manage false positives
- Tool automatically excludes common test directories
Network Dependency:
- CVE detection requires OSV API access
- Use
--skip-osv flag when offline
- Results cached for 24 hours in
~/.cache/claude-security/osv/
Performance:
- Typical: ~10,000 LOC/second
- OSV API queries add 2-5 seconds per scan
- Large codebases (>100K LOC) may take 30+ seconds
Technical Details
- Zero Dependencies - Pure Python 3.8+ standard library
- Fast Performance - Scans 12K LOC in ~0.88 seconds
- Smart Defaults - Respects
.gitignore, excludes test files
- CVE Database - Queries OSV.dev API for known vulnerabilities
- Caching - 24-hour cache for dependency vulnerability data
Configuration Options
Full CLI flag reference (--output, --config, --skip-osv, --verbose, --version, --help) is in references/configuration.md — read it when customizing a scan invocation.
Quality Metrics
This skill provides:
- Risk Score (0-100) - Weighted by severity
- Finding Counts - Breakdown by CRITICAL/HIGH/MEDIUM/LOW
- OWASP Coverage - Findings mapped to Top 10 categories
- Security Posture - Overall assessment with actionable recommendations
Version: 1.0.0
Status: Production Ready
Languages Supported: Python, JavaScript, TypeScript
Last Updated: 2026-02-08