95
/ 100
Polished and well engineered. Punching above its star count.
CLI Tool for installing & updating Ghost
Outstanding. A score of 95/100 puts this repo in a very small tier of truly well-engineered projects.
Top fixes
Highest-impact changes first, ranked by point weight
- 1Install and run instructions9pt
Add a .env.example listing all required environment variables so contributors know what to set up.
- 2Reproducibility6pt
Add a Dockerfile, .nvmrc, or .python-version to pin the runtime version and make the environment reproducible.
- 3Reproducibility6pt
Add .github/dependabot.yml with at least one package-ecosystem entry so dependencies are updated automatically.
- 4Dependency manifest6pt
Add a `build` script to package.json so the project can be compiled with `npm run build`.
Working through the fixes? Let every push regrade itself.
The free GitHub App rescans this repo on every push and posts the grade as a commit check, so the score climbs without coming back to rescan by hand.
Scorecard
Every check, grouped by category and sorted worst-first
Documentation
93
CONTRIBUTING guide found.
README documents how to install the project.
README is present.
Licensed under MIT.
Engineering
96
Lockfile present (pnpm-lock.yaml). Installs are reproducible.
Test files detected (.mocharc.json).
CI is configured (.github/workflows/e2e-test.yml).
Linter or formatter configured (.editorconfig).
Issue or PR templates present.
Project health
97
Dependency manifest found (package.json).
Repository has a description.
Actively maintained (pushed within the last month).
.gitignore present.
Repository health signals
Activity, community, and responsiveness at scan time
Activity
- 27 / 119Commits (30d / 90d)
- 235Forks
- 127Releaseslatest 9y ago
Community
- 75% - GoodCommunity health
- 2 bus factorauthors own >50% of commits
- 493Watchers
Responsiveness
- 2d 5hMedian issue response
- 2hMedian PR merge time
- 20Open issues
Repository files19 root entries
- .githubGood: CONTRIBUTING guide found.Issue: CONTRIBUTING guide contents could not be read (−28 pts vs a readable file).Fix: Move the file to the repo root or docs/CONTRIBUTING.md so its setup, style, test, and PR sections can be graded.Good: CI is configured (.github/workflows/e2e-test.yml).Good: Issue or PR templates present.
- bin
- extensions
- lib
- test
- .editorconfigGood: Linter or formatter configured (.editorconfig).
- .eslintrc.json
- .gitignoreGood: .gitignore present.
- .mocharc.jsonGood: Test files detected (.mocharc.json).
- AGENTS.md
- CHANGELOG.md
- CLAUDE.md
- LICENSEGood: Licensed under MIT.
- package.jsonGood: Dependency manifest found (package.json).
- pnpm-lock.yamlGood: Lockfile present (pnpm-lock.yaml). Installs are reproducible.
- pnpm-workspace.yaml
- README.mdGood: README is present.Good: README is well structured with multiple sections.Good: README includes screenshots or visuals. Great for first impressions.Good: README has code examples.Good: README links to a live demo or deployed app.Good: README includes status badges.Good: README documents how to install the project.Good: README documents how to run the project.
- renovate.json
- SECURITY.mdGood: Security policy present.
Add this badge to your README
It updates automatically each time the repo is re-graded.
[](https://www.repo-grade.com/report/tryghost/ghost-cli)