Skip to content

GitHub standards

This section covers the files around the code: the ones that tell someone arriving cold what a project is, what they are allowed to do with it, and how to send a change back.

Part of that is measured by GitHub itself. Every public repository has a community profile: GitHub looks for a set of standard files and reports a percentage.

Synced on 3 September 2026, across 26 public repositories. From GitHub’s community profile for github.com/nerln.

RepositoryHealthDescriptionREADMELicenceCONTRIBUTINGCode of conductPR templateIssue templates
banchina100%yesyesyesyesyesyesno
molo100%yesyesyesyesyesyesno
claude-codex-bridge71%yesyesyesyesnonono
argano42%yesyesyesnononono
boa42%yesyesyesnononono
capitaneria42%yesyesyesnononono
dogana42%yesyesyesnononono
faro42%yesyesyesnononono
japepo42%yesyesyesnononono
man5-surfaces42%yesyesyesnononono
paranco42%yesyesyesnononono
paratia42%yesyesyesnononono
placa42%yesyesyesnononono
plancia42%yesyesyesnononono
rada42%yesyesyesnononono
reflip42%yesyesyesnononono
scriba42%yesyesyesnononono
snapchat-memories-to-photos42%yesyesyesnononono
stiva42%yesyesyesnononono
varo42%yesyesyesnononono
vedetta42%yesyesyesnononono
vesta42%yesyesyesnononono
vesuvius-ladder42%yesyesyesnononono
wedding-invite-starter-kit42%yesyesyesnononono
porto28%yesyesnonononono
tratto28%yesyesnonononono

Every repository in the list has a description and a README. On licences: seventeen MIT, five GPL-3.0, two without a licence, two Apache-2.0.

Most repositories sit at the same score. They carry a description, a README and a licence, and they are missing CONTRIBUTING, a code of conduct, an issue template and a pull request template. The two at 28 percent have no licence file yet, which is the one gap on that list that matters to a reader.

molo and banchina reach 100 percent because they add CONTRIBUTING, a code of conduct and a pull request template. Their issue templates are separate files under .github/ISSUE_TEMPLATE/, which the profile’s issue template field does not report. claude-codex-bridge reaches 71 percent by adding CONTRIBUTING and nothing else.

A repository gets CONTRIBUTING when there is a real process to describe, meaning a test suite to run and a review path to follow. It gets templates when issues start arriving and I find myself asking the same questions twice. Molo went first because it has a hard boundary that a contributor could cross by accident, and that boundary needed writing down.

Four things are not optional.

A license on every repository, chosen before the first public commit.

A section in the README that says what the tool does not do, including the cases where the answer is a flat no.

A section that lists known limitations, including things that compile but have never been run on real hardware.

A check that would catch the claim if it were false, shipped in the repository, where you can run it.

The pages under Tools go through those one project at a time.