0

/ 100

GradeF

Some interest. A stronger README and CI would help.

Higher than 21% of 5,156 graded repos

一起来残酷共学 Ethereum Protocol 做好申请 Fellowship 的准备吧

A low grade is a to-do list, not a judgment of your code

Most gaps here are documentation, tests, and setup, not the code itself. Closing your top 3 gaps alone would add 25 points.

See your top fixes
Now
F
31
Potential
F
56

Top fixes

Highest-impact changes first, ranked by point weight

20 to address
  1. 1
    Tests18pt

    Add automated tests. They prove the code works and give contributors confidence to make changes.

  2. 2
    CI/CD14pt

    Add a step like `run: npm test`, `run: pytest`, or `run: tox` to your workflow file.

  3. 3
    CI/CD14pt

    Add a lint step to catch style issues automatically.

  4. 4
    CI/CD14pt

    Add `tsc --noEmit`, `mypy`, or `cargo check` to catch type errors before they merge.

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.

Install the GitHub App

Scorecard

Every check, grouped by category and sorted worst-first

Documentation

34

Install and run instructions9pt0

No install instructions found in the README (−45 pts).

→ Add a section showing how to install dependencies.

License6pt0

No license detected.

→ Add a LICENSE file. Without one, nobody can legally use, copy, or contribute to your code.

Contributing guide5pt0

No CONTRIBUTING.md found (−47 pts base + up to −53 pts more for content).

→ Add a CONTRIBUTING.md telling newcomers how to get involved. Include setup, code style, test, and PR instructions.

README12pt90

README is present.

Engineering

16

Tests18pt0

No tests detected anywhere in the repository.

→ Add automated tests. They prove the code works and give contributors confidence to make changes.

Linting and formatting5pt0

No linter or formatter config found.

→ Add a linter config such as .eslintrc.json, .prettierrc, ruff.toml, or .golangci.yml to enforce consistent code style.

Reproducibility6pt0

No dependency lockfile found (−70 pts).

→ Commit the lockfile for this project's package manager so installs produce the same dependency versions everywhere.

Issue and PR templates6pt0

No issue or PR templates found (−100 pts).

→ Add .github/ISSUE_TEMPLATE/ with bug_report.md and feature_request.md to guide contributors. It dramatically improves issue quality.

CI/CD14pt57

CI is configured (.github/workflows/ReopBot.yml).

Project health

62

Dependency manifest6pt0

No dependency manifest detected at root.

→ Add a manifest (package.json, pyproject.toml, Cargo.toml, go.mod, etc.) so others can install dependencies in one command.

Housekeeping3pt60

.gitignore present.

Repository metadata5pt100

Repository has a description.

Activity5pt100

Actively maintained (pushed within the last month).

Repository health signals

Activity, community, and responsiveness at scan time

Activity

  • -
    Commits (30d / 90d)
  • 88
    Forks
  • 0
    Releases

Community

  • -
    Community health
  • -
    authors own >50% of commits
  • 27
    Watchers

Responsiveness

  • 5d 10h
    Median issue response
  • <1h
    Median PR merge time
  • 0
    Open issues
Repository files96 root entries
  • .github
    Good: CI is configured (.github/workflows/ReopBot.yml).
  • .idea
    Good: .gitignore present.
    Issue: Build artifacts or local files may be committed (.idea/.gitignore) (−40 pts).Fix: Remove them and add to .gitignore.
  • .starrydeserts_image
  • img
  • 0xKarl98.md
  • 0xNezha.md
  • affe.md
  • ALiangNe.md
  • amandakelake.md
  • Amberrrrrr.md
  • armada2013.md
  • awsomecty.md
  • Azleal.md
  • brucexu-eth.md
  • buctor41.md
  • CHENFANGC.md
  • cherry-yl-sh.md
  • chloezhu010.md
  • chyyynh.md
  • CJC824.md
  • Coooder-Crypto.md
  • cooper.md
  • d0d0d9.md
  • dajuguan.md
  • DasNarrenschiff.md
  • debugzhao.md
  • deporter.md
  • dethan3.md
  • devbards.md
  • dixia.md
  • dundun930326.md
  • DVDguzhou.md
  • Echocipher.md
  • eddy8.md
  • Eizz0.md
  • evanwu.md
  • frankmint2024.md
  • Garyamour.md
  • ghx1104.md
  • GuoyangLiu24.md
  • HeliosLz.md
  • Henry.md
  • henryleo.md
  • hotoo.md
  • huahuahua1223.md
  • huangyan0914.md
  • JC13043DB.md
  • JeasonZhang.md
  • jjeejj.md
  • JoscelynFarr.md
  • Juktong.md
  • k66.md
  • kernel1983.md
  • keroro520.md
  • kidneyweakx.md
  • KieSun.md
  • lanpan999.md
  • letsgoexplore.md
  • LikKee.md
  • liuxulife.md
  • lknxt1995.md
  • lllapland.md
  • LouisTsai-Csie.md
  • luffythink.md
  • Lvista.md
  • marvelshan.md
  • mrmign.md
  • nooma42.md
  • passer-byzhang.md
  • PayFv.md
  • phoebe-dot.md
  • pillowtalk-Qy.md
  • poyucheese.md
  • ppatrick007.md
  • PubYuCHe.md
  • rayjun.md
  • README.md
    Good: 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.
    Issue: No status badges in the README (−10 pts).Fix: Add CI/build status badges from shields.io or your CI provider to signal project health.
    Issue: No install instructions found in the README (−45 pts).Fix: Add a section showing how to install dependencies.
    Issue: No run or usage instructions found (−45 pts).Fix: Add a section showing how to start or use the project.
  • realgu.md
  • rectinajh.md
  • rogers3333.md
  • StarryDeserts.md
  • StellaWang5209.md
  • StillFantastic.md
  • sync_status_readme.py
  • tannerang.md
  • Template.md
  • tienshaoku.md
  • timfaner.md
  • William-02-02.md
  • yahsinhuangtw.md
  • yenchihliao.md
  • yiwen4.md
  • yoona333.md
  • zhouCode.md
  • zhwindy.md
  • zt2.md
RepoGrade badge preview

Add this badge to your README

It updates automatically each time the repo is re-graded.

[![RepoGrade](https://www.repo-grade.com/api/badge/intensivecolearning/ethereum-protocol-fellowship)](https://www.repo-grade.com/report/intensivecolearning/ethereum-protocol-fellowship)

More graded Python repos