repository-health-review
USE FOR: judging how well a repository is maintained overall — release cadence, branch and proposal age, issue inflow, build reliability, how many people can maintain it, and outstanding alert counts. NOT FOR: acting on any individual issue, alert or proposed change, or cutting a specific release.
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 3.4w
- Forks
- 5.3k
01 前言 Front Matter
- name
- repository-health-review
- description
- USE FOR: judging how well a repository is maintained overall — release cadence, branch and proposal age, issue inflow, build reliability, how many people can maintain it, and outstanding alert counts. NOT FOR: acting on any individual issue, alert or proposed change, or cutting a specific release.
03 SKILL.md 正文
Assessing repository health
Produce an evidence-backed picture of how a repository is doing across a few independent dimensions.
This workflow makes no changes. Every tool it uses is read-only. If a specific issue, alert or pull request needs action, that is separate work — name it and hand it over rather than starting it here.
Sequence
Gather each dimension independently, so one unavailable source does not sink the report.
- Activity.
list_commitswithsinceset to ninety days ago gives commit volume and who is contributing.list_releasesgives cadence — the gaps betweenpublished_atvalues say more than the count. - Branch hygiene.
list_branches, then check the age of each branch's head commit. Many long-untouched branches usually mean the project does not prune, which is a mild signal on its own and a stronger one alongside slow pull request flow. - Flow.
list_pull_requestswithstate: open,sort: createdanddirection: ascputs the oldest first; the age of the oldest and the shape of the distribution are the numbers worth reporting.list_issueswithstate: OPEN,orderBy: CREATED_ATanddirection: ASCdoes the same for issues. - CI reliability.
actions_listwithmethod: list_workflow_runs, filtered to the default branch, over a recent window. The ratio ofconclusion: successto failures on the default branch is the signal; failures on feature branches are expected and are not. - Maintainer coverage.
list_repository_collaboratorsshows how many people can maintain the repository. One active committer is a risk worth naming plainly. - Outstanding risk.
list_code_scanning_alertsandlist_dependabot_alertswithstate: open, counted by severity only. Do not open individual alerts here. - Report per dimension, each with the numbers behind it, and state which dimensions could not be assessed.
Decision points
- Absent history is not poor health. A repository with few commits, no releases and no alerts may be new. Say insufficient history rather than scoring it.
- Low activity is not decay. A stable, finished library should look quiet. Weigh activity against open issues and unanswered pull requests, not on its own.
- What counts as stale depends on the project's own cadence. Derive the threshold from its release and merge intervals rather than importing a fixed number, and state the threshold you used.
- When to stop. This produces an assessment. If it surfaces something urgent — a critical alert, a default branch that has been failing for weeks — name it clearly and hand it over.
Fields that matter
published_atacross releases — the intervals are the cadence.- The head commit date per branch — branch names carry no age.
created_aton the oldest open pull request — a single number that captures review responsiveness better than a count.conclusionandhead_branchon workflow runs — filter to the default branch, or the failure rate is meaningless.stateon alerts — countopenonly;dismissedandfixedare noise here.affiliationon collaborators —directandoutsideanswer different questions about who really maintains the repository.
Confirm before changing anything
Nothing here changes anything, so no confirmation is needed to run it. If the assessment leads to a proposal — pruning branches, closing stale issues, upgrading a dependency — that proposal is a separate decision that needs its own agreement before anyone acts.
Empty and failure cases
- A dimension cannot be assessed — mark it not assessed and name the reason. Never infer health from a missing signal, and never let one unavailable source suppress the rest of the report.
- No releases — report no release history rather than a bad cadence; plenty of repositories legitimately never release.
- No open issues or pull requests — that is a clean result for flow, but check activity before calling it healthy, since it also describes an abandoned repository.
- Alert sources unavailable — say the risk dimension was not assessed. An empty result and a disabled feature are different answers.
- A very large repository — page rather than raising limits, and if a dimension is too large to sample fairly, say the number is approximate and how it was derived.
04 同仓库更多 Skills
workflow-failure-triage
USE FOR: diagnosing a failing GitHub Actions workflow run — a build gone red, which jobs failed, what their logs say, where the failing step is, and whether a rerun is justified. NOT FOR: judging long-term reliability trends across a repository, or deciding whether a change is ready to ship.
security-alert-triage
USE FOR: investigating GitHub security alerts — code scanning, Dependabot, secret scanning and advisories — and deciding what to fix now, schedule, dismiss, or escalate. NOT FOR: summarising overall repository health, or reviewing feedback on a pull request.
repository-discovery
USE FOR: finding a library, tool or organisation you cannot yet name, judging whether a candidate project is worth depending on, and keeping a starred shortlist useful. NOT FOR: searching inside a repository you have already chosen, or setting one up.
repository-content-changes
USE FOR: changing what a repository holds or whether it exists at all — opening a working branch, committing files remotely, deleting what should go, and creating, forking or removing the repository itself. NOT FOR: proposing those changes for review, or reading code you do not intend to touch.
release-preparation
USE FOR: cutting a release of a repository — picking the version, assembling the changelog since the last tag, confirming the branch is releasable, and drafting release notes. NOT FOR: assessing overall repository health, triaging security alerts, or working an issue backlog.
pull-request-review-feedback
USE FOR: working through review feedback left on a pull request — reading each unresolved thread, deciding what to change, replying to the reviewer, and resolving threads. NOT FOR: producing a review of a pull request, merging one, or clearing a notification inbox.