💡 Turn your README into tested code.
This GitHub Action runs LLM-powered unit tests on your README.md
using Google’s Gemini API
**.
You can now **customize which checks to run, generate markdown reports, and keep your workflows
green.
✅ What it checks
- 📌 Project description
- 🧪 Installation instructions
- 🧰 Usage examples
- 📄 License info
- 📸 Screenshot or live demo link
Tip: You can disable specific tests using the
checks
input.
🚀 Quickstart
Drop this into your workflow to automatically test your README:
- uses: atick-faisal/llm-readme-tester@v1
with:
google_api_key: $
checks: "description,install,license" # optional, default is "all"
🧠 Available check keywords: description
, install
, usage
, license
, demo
🔐 Add your Gemini API key as a secret named GOOGLE_API_KEY
.
🧪 Example Output
test_readme.py ....F [100%]
FAILED test_readme.py::test_license_info - ❌ License information is missing.
📚 Docs & Community
- 🤝 Contributing Guide
- ✨ Code of Conduct
- 🧪 Test Case Discussion
Suggest new checks, vote on ideas, and bring the README police to life