Github Repo Candidate Quality Gate

Name: Github Repo Candidate Quality Gate
Author: akillness

akillness/oh-my-skills

139 installs
40 repo stars
Updated August 4, 2026
akillness/oh-my-skills

Score and filter GitHub repo candidates against maintainability, activity, and fit before adopting a dependency or fork base.

About

Applies a repeatable quality gate to GitHub repository candidates—checking signals like maintenance cadence, issue hygiene, test presence, and project fit—so teams reject risky deps early and document why a repo was accepted or ruled out.

Structured repo scoring rubric
Maintainability and activity signals
License and risk checks
Shortlist vs reject decisions
Consistent candidate comparison

Github Repo Candidate Quality Gate by the numbers

139 all-time installs (skills.sh)
Ranked #388 of 1,352 Code Review & Quality skills by installs in the Skillselion catalog
Data as of Aug 5, 2026 (Skillselion catalog sync)

npx skills add https://github.com/akillness/oh-my-skills --skill github-repo-candidate-quality-gate

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/akillness/oh-my-skills/github-repo-candidate-quality-gate.svg)](https://skillselion.com/skills/akillness/oh-my-skills/github-repo-candidate-quality-gate)

Installs	139
repo stars	★ 40
Last updated	August 4, 2026
Repository	akillness/oh-my-skills ↗

What it does

Score and filter GitHub repo candidates against maintainability, activity, and fit before adopting a dependency or fork base.

Files

SKILL.mdMarkdownGitHub ↗

GitHub Repo Candidate Quality Gate

Use this skill when broad GitHub search output is too noisy for merge-ready recommendations.

When to use

You already ran gh search repos (or equivalent) and need recommendation-grade keeps.
You must preserve broad discovery evidence while filtering keeps deterministically.
You need lane-level status + degraded-cause reporting for unattended cron review.

Minimum keep metadata

For every kept candidate, capture all fields:

full_name
url
license
pushed_at (or updated_at fallback)
archived
stars
one-line fit rationale
provenance label

Quality gate order

1. License gate: drop missing/unknown license unless explicit exception rationale. 2. Archive gate: drop archived repos by default. 3. Freshness gate: drop if pushed_at older than 24 months unless exception + risk. 4. Fit gate: drop keyword-only mismatches (low-fit). 5. Signal gate: keep broad discovery evidence, but recommendation-grade keeps require traction (default: stars >= 3) or explicit adoption rationale.

Reporting contract

Keep and publish full discovery counts even when keeps are sparse.
Emit lane_status: pass|degraded.
Emit degraded_causes counts using: license, stale, low-fit, archived, low-signal, no-results.
When a lane ends with raw_count == 0 after documented recovery, include no-results explicitly to keep degraded reports deterministic.
Include lane health metrics: kept_count, raw_count, median_stars_raw, zero_star_raw.
State provenance labels used (direct page retrieval, indexed snippet, etc.).

Rollback-safe operation

Never delete raw evidence files.
If stricter gates reduce keep counts too far, preserve output but mark lane degraded.
Allow exception keeps only when rationale + risk note are explicit.

Example

Input: 30 raw hits, many zero-star repos.
Output: discovery evidence retained, recommendation keeps filtered by metadata/freshness/signal gates, degraded causes documented for reviewer.

{
  "skill_name": "github-repo-candidate-quality-gate",
  "evals": [
    {
      "id": 1,
      "prompt": "Triaging hourly GitHub search results where one lane has mostly zero-star repos but still needs reviewer-ready output",
      "expected_output": "The skill keeps raw evidence, applies deterministic metadata/freshness/signal gates for recommendation keeps, and reports lane_status with low-signal degraded causes.",
      "assertions": [
        "Preserves broad discovery evidence even when strict keeps are few",
        "Uses deterministic gate order including a signal gate",
        "Reports degraded_causes including low-signal when applicable"
      ]
    }
  ]
}

N:github-repo-candidate-quality-gate
D:Convert noisy GitHub repo search results into recommendation-grade keep lists with deterministic metadata, freshness, fit, and signal gates while preserving discovery evidence.
G:github search triage quality-gate repo-maintenance
U[4]:
  Filter broad repo-search output into merge-ready recommendation lists
  Preserve raw discovery evidence while hardening keep quality
  Emit lane_status and degraded_causes with reviewer-friendly metrics
  Keep exception handling explicit with rationale and risk notes
S[6]{n,action,details}:
  1,Collect raw hits,Use gh search repos or equivalent and store raw evidence
  2,Normalize metadata,Capture license pushed_at updated_at archived stars fit rationale provenance
  3,Apply deterministic gates,Run license archive freshness fit signal checks in fixed order
  4,Compute lane metrics,Calculate kept_count raw_count median_stars_raw zero_star_raw
  5,Report lane status,Emit pass or degraded plus degraded_causes taxonomy counts
  6,Finalize safely,Keep raw evidence and document exceptions with risk notes
R[5]:
  Do not drop raw discovery evidence
  Treat unknown license as drop-by-default unless explicit exception rationale
  Apply 24-month freshness floor for recommendation-grade keeps by default
  Use traction signal gate for recommendation-grade keeps (default stars>=3)
  Report degraded_causes with license stale low-fit archived low-signal taxonomy
E[1]{desc,in,out}:
  "Hourly maintenance lane triage","Filter gh search repos output into merge-grade recommendations","Returns deterministic keep list plus lane metrics/status without losing discovery evidence"