CryptoLint -- Cryptography Misuse & Weak Algorithm Detector
CryptoLint scans codebases for cryptographic anti-patterns, deprecated algorithms (MD5, SHA-1, DES, RC4), hardcoded keys and IVs, insecure encryption modes (ECB), weak random number generation, timing-vulnerable comparisons, and insecure TLS/SSL configuration. It uses regex-based pattern matching against 90 cryptography-specific patterns across 6 categories, lefthook for git hook integration, and produces markdown reports with actionable remediation guidance. 100% local. Zero telemetry.
Commands
Free Tier (No license required)
cryptolint scan [file|directory]
One-shot cryptography quality scan of files or directories.
How to execute:
bash "<SKILL_DIR>/scripts/dispatcher.sh" --path [target]
What it does:
- Accepts a file path or directory (defaults to current directory)
- Discovers all source files (skips .git, node_modules, binaries, images, .min.js)
- Runs 30 cryptography patterns against each file (free tier limit)
- Calculates a crypto quality score (0-100) per file and overall
- Grades: A (90-100), B (80-89), C (70-79), D (60-69), F (<60)
- Outputs findings with: file, line number, check ID, severity, description, recommendation
- Exit code 0 if score >= 70, exit code 1 if crypto quality is poor
- Free tier limited to first 30 patterns (WA + KM categories)
Example usage scenarios:
- "Scan my code for crypto issues" -> runs
cryptolint scan .
- "Check this file for weak algorithms" -> runs
cryptolint scan src/crypto.ts
- "Find hardcoded encryption keys" -> runs
cryptolint scan src/
- "Audit cryptography usage in my project" -> runs
cryptolint scan .
- "Check for MD5 or SHA1 usage" -> runs
cryptolint scan .
Pro Tier ($19/user/month -- requires CRYPTOLINT_LICENSE_KEY)
cryptolint scan --tier pro [file|directory]
Extended scan with 60 patterns covering weak algorithms, key management, encryption modes, and random number generation.
How to execute:
bash "<SKILL_DIR>/scripts/dispatcher.sh" --path [target] --tier pro
What it does:
- Validates Pro+ license
- Runs 60 cryptography patterns (WA, KM, EM, RN categories)
- Detects insecure encryption modes (ECB, CBC without auth)
- Identifies weak random number generation for crypto
- Full category breakdown reporting
cryptolint scan --format json [directory]
Generate JSON output for CI/CD integration.
bash "<SKILL_DIR>/scripts/dispatcher.sh" --path [directory] --format json
cryptolint scan --format html [directory]
Generate HTML report for browser viewing.
bash "<SKILL_DIR>/scripts/dispatcher.sh" --path [directory] --format html
cryptolint scan --category WA [directory]
Filter scan to a specific check category (WA, KM, EM, RN, TC, CP).
bash "<SKILL_DIR>/scripts/dispatcher.sh" --path [directory] --category WA
Team Tier ($39/user/month -- requires CRYPTOLINT_LICENSE_KEY with team tier)
cryptolint scan --tier team [directory]
Full scan with all 90 patterns across all 6 categories including timing attacks and certificate/protocol checks.
How to execute:
bash "<SKILL_DIR>/scripts/dispatcher.sh" --path [directory] --tier team
What it does:
- Validates Team+ license
- Runs all 90 patterns across 6 categories
- Includes timing & comparison checks (timing side-channels, non-constant-time comparison)
- Includes certificate & protocol checks (TLS verification disabled, insecure protocols)
- Full category breakdown with per-file results
cryptolint scan --verbose [directory]
Verbose output showing every matched line and pattern details.
bash "<SKILL_DIR>/scripts/dispatcher.sh" --path [directory] --verbose
cryptolint status
Show license and configuration information.
bash "<SKILL_DIR>/scripts/dispatcher.sh" status
Check Categories
CryptoLint detects 90 cryptographic anti-patterns across 6 categories:
| Category |
Code |
Patterns |
Description |
Severity Range |
| Weak Algorithms |
WA |
15 |
MD5, SHA-1, DES, 3DES, RC4, Blowfish, weak PBKDF2 iterations, deprecated TLS versions |
high -- critical |
| Key Management |
KM |
15 |
Hardcoded encryption keys, static IVs/salts, short keys, keys in source code, zero IVs |
high -- critical |
| Encryption Modes |
EM |
15 |
ECB mode, CBC without authentication, raw RSA without padding, deprecated createCipher |
medium -- critical |
| Random Number Generation |
RN |
15 |
Math.random() for security, java.util.Random for crypto, time-seeded RNG, predictable seeds |
high -- critical |
| Timing & Comparison |
TC |
15 |
String equality for hashes, == for HMAC, non-constant-time comparisons, early-return timing leaks |
medium -- high |
| Certificate & Protocol |
CP |
15 |
SSL/TLS verification disabled, hostname check bypassed, insecure protocol versions, HTTP in auth |
high -- critical |
Tier-Based Pattern Access
| Tier |
Patterns |
Categories |
| Free |
30 |
WA, KM |
| Pro |
60 |
WA, KM, EM, RN |
| Team |
90 |
WA, KM, EM, RN, TC, CP |
| Enterprise |
90 |
WA, KM, EM, RN, TC, CP + priority support |
Scoring
CryptoLint uses a deductive scoring system starting at 100 (perfect):
| Severity |
Point Deduction |
Description |
| Critical |
-25 per finding |
Broken algorithm or direct cryptographic vulnerability |
| High |
-15 per finding |
Significant cryptographic weakness (deprecated algo, weak key) |
| Medium |
-8 per finding |
Suboptimal practice (CBC without auth, weak mode choice) |
| Low |
-3 per finding |
Informational / best practice suggestion |
Grading Scale
| Grade |
Score Range |
Meaning |
| A |
90-100 |
Excellent cryptography practices |
| B |
80-89 |
Good crypto with minor issues |
| C |
70-79 |
Acceptable but needs improvement |
| D |
60-69 |
Poor cryptography quality |
| F |
Below 60 |
Critical cryptography problems |
- Pass threshold: 70 (Grade C or better)
- Exit code 0 = pass (score >= 70)
- Exit code 1 = fail (score < 70)
Configuration
Users can configure CryptoLint in ~/.openclaw/openclaw.json:
{
"skills": {
"entries": {
"cryptolint": {
"enabled": true,
"apiKey": "YOUR_LICENSE_KEY_HERE",
"config": {
"severityThreshold": "medium",
"ignorePatterns": ["**/test/**", "**/fixtures/**", "**/*.test.*"],
"ignoreChecks": [],
"reportFormat": "text"
}
}
}
}
}
Important Notes
- Free tier works immediately with no configuration
- All scanning happens locally -- no code is sent to external servers
- License validation is offline -- no phone-home or network calls
- Pattern matching only -- no AST parsing, no external dependencies beyond bash
- Supports scanning all file types in a single pass
- Git hooks use lefthook which must be installed (see install metadata above)
- Exit codes: 0 = pass (score >= 70), 1 = fail (for CI/CD integration)
- Output formats: text (default), json, html
Error Handling
- If lefthook is not installed and user tries hooks, prompt to install it
- If license key is invalid or expired, show clear message with link to https://cryptolint.pages.dev/renew
- If a file is binary, skip it automatically with no warning
- If no scannable files found in target, report clean scan with info message
- If an invalid category is specified with --category, show available categories
When to Use CryptoLint
The user might say things like:
- "Scan my code for crypto issues"
- "Check my cryptography usage"
- "Find weak algorithms in my code"
- "Detect hardcoded encryption keys"
- "Are there any MD5 or SHA1 uses?"
- "Check for insecure encryption modes"
- "Audit my TLS configuration"
- "Find ECB mode usage"
- "Check for timing attack vulnerabilities"
- "Scan for weak random number generation"
- "Run a cryptography audit"
- "Generate a crypto quality report"
- "Check if Math.random is used for security"
- "Find hardcoded IVs and salts"
- "Check my code for crypto anti-patterns"
1---2name: cryptolint-23version: 1.0.04description: "Cryptography misuse & weak algorithm detector -- detects deprecated algorithms, hardcoded keys/IVs, ECB mode, weak random number generation, timing-vulnerable comparisons, and insecure TLS configuration"5homepage: https://cryptolint.pages.dev6metadata:7 source: https://skillmd.com/skills/bishal-pdmsft/cryptolint-28 openclaw:9 emoji: 🔐10 primaryEnv: CRYPTOLINT_LICENSE_KEY11 requires:12 bins:13 - git14 - bash15 - python316 - jq17 configPaths:18 - ~/.openclaw/openclaw.json19 install:20 - id: lefthook21 kind: brew22 formula: lefthook23 bins:24 - lefthook25 label: Install lefthook (git hooks manager)26 os:27 - darwin28 - linux29 - win3230user-invocable: true31disable-model-invocation: false32---3334# CryptoLint -- Cryptography Misuse & Weak Algorithm Detector3536CryptoLint scans codebases for cryptographic anti-patterns, deprecated algorithms (MD5, SHA-1, DES, RC4), hardcoded keys and IVs, insecure encryption modes (ECB), weak random number generation, timing-vulnerable comparisons, and insecure TLS/SSL configuration. It uses regex-based pattern matching against 90 cryptography-specific patterns across 6 categories, lefthook for git hook integration, and produces markdown reports with actionable remediation guidance. 100% local. Zero telemetry.3738## Commands3940### Free Tier (No license required)4142#### `cryptolint scan [file|directory]`43One-shot cryptography quality scan of files or directories.4445**How to execute:**46```bash47bash "<SKILL_DIR>/scripts/dispatcher.sh" --path [target]48```4950**What it does:**511. Accepts a file path or directory (defaults to current directory)522. Discovers all source files (skips .git, node_modules, binaries, images, .min.js)533. Runs 30 cryptography patterns against each file (free tier limit)544. Calculates a crypto quality score (0-100) per file and overall555. Grades: A (90-100), B (80-89), C (70-79), D (60-69), F (<60)566. Outputs findings with: file, line number, check ID, severity, description, recommendation577. Exit code 0 if score >= 70, exit code 1 if crypto quality is poor588. Free tier limited to first 30 patterns (WA + KM categories)5960**Example usage scenarios:**61- "Scan my code for crypto issues" -> runs `cryptolint scan .`62- "Check this file for weak algorithms" -> runs `cryptolint scan src/crypto.ts`63- "Find hardcoded encryption keys" -> runs `cryptolint scan src/`64- "Audit cryptography usage in my project" -> runs `cryptolint scan .`65- "Check for MD5 or SHA1 usage" -> runs `cryptolint scan .`6667### Pro Tier ($19/user/month -- requires CRYPTOLINT_LICENSE_KEY)6869#### `cryptolint scan --tier pro [file|directory]`70Extended scan with 60 patterns covering weak algorithms, key management, encryption modes, and random number generation.7172**How to execute:**73```bash74bash "<SKILL_DIR>/scripts/dispatcher.sh" --path [target] --tier pro75```7677**What it does:**781. Validates Pro+ license792. Runs 60 cryptography patterns (WA, KM, EM, RN categories)803. Detects insecure encryption modes (ECB, CBC without auth)814. Identifies weak random number generation for crypto825. Full category breakdown reporting8384#### `cryptolint scan --format json [directory]`85Generate JSON output for CI/CD integration.8687```bash88bash "<SKILL_DIR>/scripts/dispatcher.sh" --path [directory] --format json89```9091#### `cryptolint scan --format html [directory]`92Generate HTML report for browser viewing.9394```bash95bash "<SKILL_DIR>/scripts/dispatcher.sh" --path [directory] --format html96```9798#### `cryptolint scan --category WA [directory]`99Filter scan to a specific check category (WA, KM, EM, RN, TC, CP).100101```bash102bash "<SKILL_DIR>/scripts/dispatcher.sh" --path [directory] --category WA103```104105### Team Tier ($39/user/month -- requires CRYPTOLINT_LICENSE_KEY with team tier)106107#### `cryptolint scan --tier team [directory]`108Full scan with all 90 patterns across all 6 categories including timing attacks and certificate/protocol checks.109110**How to execute:**111```bash112bash "<SKILL_DIR>/scripts/dispatcher.sh" --path [directory] --tier team113```114115**What it does:**1161. Validates Team+ license1172. Runs all 90 patterns across 6 categories1183. Includes timing & comparison checks (timing side-channels, non-constant-time comparison)1194. Includes certificate & protocol checks (TLS verification disabled, insecure protocols)1205. Full category breakdown with per-file results121122#### `cryptolint scan --verbose [directory]`123Verbose output showing every matched line and pattern details.124125```bash126bash "<SKILL_DIR>/scripts/dispatcher.sh" --path [directory] --verbose127```128129#### `cryptolint status`130Show license and configuration information.131132```bash133bash "<SKILL_DIR>/scripts/dispatcher.sh" status134```135136## Check Categories137138CryptoLint detects 90 cryptographic anti-patterns across 6 categories:139140| Category | Code | Patterns | Description | Severity Range |141|----------|------|----------|-------------|----------------|142| **Weak Algorithms** | WA | 15 | MD5, SHA-1, DES, 3DES, RC4, Blowfish, weak PBKDF2 iterations, deprecated TLS versions | high -- critical |143| **Key Management** | KM | 15 | Hardcoded encryption keys, static IVs/salts, short keys, keys in source code, zero IVs | high -- critical |144| **Encryption Modes** | EM | 15 | ECB mode, CBC without authentication, raw RSA without padding, deprecated createCipher | medium -- critical |145| **Random Number Generation** | RN | 15 | Math.random() for security, java.util.Random for crypto, time-seeded RNG, predictable seeds | high -- critical |146| **Timing & Comparison** | TC | 15 | String equality for hashes, == for HMAC, non-constant-time comparisons, early-return timing leaks | medium -- high |147| **Certificate & Protocol** | CP | 15 | SSL/TLS verification disabled, hostname check bypassed, insecure protocol versions, HTTP in auth | high -- critical |148149## Tier-Based Pattern Access150151| Tier | Patterns | Categories |152|------|----------|------------|153| **Free** | 30 | WA, KM |154| **Pro** | 60 | WA, KM, EM, RN |155| **Team** | 90 | WA, KM, EM, RN, TC, CP |156| **Enterprise** | 90 | WA, KM, EM, RN, TC, CP + priority support |157158## Scoring159160CryptoLint uses a deductive scoring system starting at 100 (perfect):161162| Severity | Point Deduction | Description |163|----------|-----------------|-------------|164| **Critical** | -25 per finding | Broken algorithm or direct cryptographic vulnerability |165| **High** | -15 per finding | Significant cryptographic weakness (deprecated algo, weak key) |166| **Medium** | -8 per finding | Suboptimal practice (CBC without auth, weak mode choice) |167| **Low** | -3 per finding | Informational / best practice suggestion |168169### Grading Scale170171| Grade | Score Range | Meaning |172|-------|-------------|---------|173| **A** | 90-100 | Excellent cryptography practices |174| **B** | 80-89 | Good crypto with minor issues |175| **C** | 70-79 | Acceptable but needs improvement |176| **D** | 60-69 | Poor cryptography quality |177| **F** | Below 60 | Critical cryptography problems |178179- **Pass threshold:** 70 (Grade C or better)180- Exit code 0 = pass (score >= 70)181- Exit code 1 = fail (score < 70)182183## Configuration184185Users can configure CryptoLint in `~/.openclaw/openclaw.json`:186187```json188{189 "skills": {190 "entries": {191 "cryptolint": {192 "enabled": true,193 "apiKey": "YOUR_LICENSE_KEY_HERE",194 "config": {195 "severityThreshold": "medium",196 "ignorePatterns": ["**/test/**", "**/fixtures/**", "**/*.test.*"],197 "ignoreChecks": [],198 "reportFormat": "text"199 }200 }201 }202 }203}204```205206## Important Notes207208- **Free tier** works immediately with no configuration209- **All scanning happens locally** -- no code is sent to external servers210- **License validation is offline** -- no phone-home or network calls211- Pattern matching only -- no AST parsing, no external dependencies beyond bash212- Supports scanning all file types in a single pass213- Git hooks use **lefthook** which must be installed (see install metadata above)214- Exit codes: 0 = pass (score >= 70), 1 = fail (for CI/CD integration)215- Output formats: text (default), json, html216217## Error Handling218219- If lefthook is not installed and user tries hooks, prompt to install it220- If license key is invalid or expired, show clear message with link to https://cryptolint.pages.dev/renew221- If a file is binary, skip it automatically with no warning222- If no scannable files found in target, report clean scan with info message223- If an invalid category is specified with --category, show available categories224225## When to Use CryptoLint226227The user might say things like:228- "Scan my code for crypto issues"229- "Check my cryptography usage"230- "Find weak algorithms in my code"231- "Detect hardcoded encryption keys"232- "Are there any MD5 or SHA1 uses?"233- "Check for insecure encryption modes"234- "Audit my TLS configuration"235- "Find ECB mode usage"236- "Check for timing attack vulnerabilities"237- "Scan for weak random number generation"238- "Run a cryptography audit"239- "Generate a crypto quality report"240- "Check if Math.random is used for security"241- "Find hardcoded IVs and salts"242- "Check my code for crypto anti-patterns"