JaaasperLiu

JaaasperLiu / repo-doctor

Public

Scan any repo against 17 open-source best practices and auto-generate missing files. One command to go from messy to professional.

github.comJasperLiu1999repo-doctor best-practices cli developer-tools devtools github
10
0
100% credibility
Found Mar 07, 2026 at 10 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

Repo Doctor scans project folders for open-source best practices, assigns a health score out of 100, and automatically creates missing standard files like README, LICENSE, and contribution guides without altering source code.

How It Works

1
🕵️ Discover Repo Doctor

You're polishing your project and find this friendly helper that checks if everything looks professional.

2
💻 Add it to your computer

With one easy step, you bring Repo Doctor onto your machine so it's ready to use.

3
🔍 Point it at your project

You tell it where your project folder is, and it quickly scans to see what's great and what needs a little love.

4
📊 See your score

A clear report pops up with a grade like A or B, listing simple ways to make your project even better.

5
👀 Preview improvements

It shows exactly what new helpful files it wants to add, like a welcome note or rules for helpers, without changing your work.

6
✨ Make it perfect

You give the okay, and it adds all the pro touches automatically, keeping everything safe.

🎉 Project shines!

Your project now has a top score, looks super professional, and is all set for others to enjoy and join.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 10 to 10 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is repo-doctor?

Repo-doctor is a Python CLI tool that scans any Git repo against 17 open-source best practices—like README presence, LICENSE files, CI workflows, and security checks—and generates a doctor report with a 0-100 health score plus grades (A-D). It auto-fixes issues by creating missing files such as CONTRIBUTING.md, .gitignore, or GitHub Actions YAML, all stack-aware for Python, Node, Rust, Go, or Swift projects. Run `repo-doctor scan /path/to/repo` for a report, or `repo-doctor fix --yes` to professionalize without touching source code.

Why is it gaining traction?

It stands out with safe auto-fixes for 12 of 17 rules, rich diff previews, dry-runs, and JSON/MD outputs perfect for CI via its GitHub Action that scans github actions or fails builds on issues. Developers hook on the one-command upgrade from messy repo to polished OSS, plus scans for secrets, high-entropy strings (scan github for credentials), venv commits, or malware-like risks—faster than manual checklists or tools like repo paint doctor review.

Who should use this?

Open-source maintainers auditing repos before release, solo devs spinning up new projects (scan anything from krypto book repo to plague doctor repo game), or team leads enforcing hygiene across Python/Node teams. Ideal for quick scans github code or scan github for malware before PRs, especially if you're tired of boilerplate like writing CI or security policies.

Verdict

Grab it for alpha-stage repo audits—solid docs, 79 tests, and it self-scores 100/100—but with 10 stars and 1.0% credibility, treat as experimental; test on non-critical repos first. Worth pipx installing for the fix workflow alone.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.