Prompt Linter
Lint AI prompts for clarity, safety, injection risk, and template validity — scored 0-100.
Keywords: lint, prompt, ai, cli, safety, quality, python, open-source, agent, automation, MIT
Part of the itsPremkumar Hermes / OpenClaw / Paperclip agent stack — 31 free, MIT-licensed, CI-tested agent-native tools.
What it does
Bad prompts produce bad outputs; quality isn't measurable. Prompt Linter solves this: Lint AI prompts for clarity, safety, injection risk, and template validity — scored 0-100.
Best for: Prompt engineers, agent builders, and AI product teams.
Features
- Lint a prompt file
- Score quality 0-100
- Detect injection risk
- Validate template vars
- JSON output for CI
Install
# Requires Python 3.8+. No pip install needed.
curl -O https://raw.githubusercontent.com/itsPremkumar/prompt-lint/main/prompt_lint.py
# Or copy the file anywhere — it's self-contained.
Quick start
python prompt_lint.py self-test # prove it works end-to-end
python prompt_lint.py check --help # check subcommand
Use cases
- Lint a prompt file
- Score quality 0-100
- Detect injection risk
- Validate template vars
- JSON output for CI
Why choose this over alternatives
| Alternative | Why this skill is better |
|---|---|
| Eyeballing prompts | Measurable quality + safety. |
| Partial linters | Adds injection + template checks. |
| No gate | CI-ready scoring. |
FAQ (SEO / AEO)
Q: Score?
A: 0-100 quality score with reasons.
Q: Injection?
A: Flags prompt-injection patterns.
Q: CI?
A: Yes — --json, non-zero on failure.
Q: Offline?
A: Yes.
Geo / local reach
Built and maintained by @itsPremkumar (Chennai, India · serving developers worldwide). Free for individuals and teams everywhere. Documentation in English; tool output is locale-neutral.
CI integration
# .github/workflows/verify.yml
name: Verify
on: [push]
jobs:
verify:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Self-test prompt-lint
run: python prompt_lint.py self-test
Support
Free + MIT-0 (free, modifiable, no attribution required). Sponsor if useful:
- GitHub Sponsors: https://github.com/sponsors/itsPremkumar
- Buy Me a Coffee: https://buymeacoffee.com/itsPremkumar
⭐ Star on GitHub