Skip to content
Skillv1.0.0

github-repo-candidate-quality-gate

Convert noisy GitHub repository search results into recommendation-grade candidate lists with explicit metadata, freshness, traction signal, provenance labels, and rollback-safe reporting for maintena

by akillness(0) 0 installs
Free
Sign in to install

Free account. Installing gives you the manifest plus copy-paste snippets.

See reviews

About

Imported from akillness/jeo-skills (.agent-skills/github-repo-candidate-quality-gate/SKILL.md). Install upstream with npx skills add akillness/jeo-skills --skill github-repo-candidate-quality-gate. Copyright stays with the author (MIT).

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.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml
targets:
  - https://api.opensmartroute.ai/api/v1/registry/akillness-jeo-skills-github-repo-candidate-quality-gate/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

akillness-jeo-skills-github-repo-candidate-quality-gate.ocm.jsonjson
{
  "ocm": "1",
  "id": "akillness-jeo-skills-github-repo-candidate-quality-gate",
  "kind": "skill",
  "name": "github-repo-candidate-quality-gate",
  "description": "Convert noisy GitHub repository search results into recommendation-grade candidate lists with explicit metadata, freshness, traction signal, provenance labels, and rollback-safe reporting for maintenance PR workflows.",
  "publisher": "akillness",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "github",
      "search",
      "triage",
      "quality-gate",
      "repo-maintenance",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Convert noisy GitHub repository search results into recommendation-grade candidate lists with explicit metadata, freshness, traction signal, provenance labels, and rollback-safe reporting for maintenance PR workflows."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/akillness/jeo-skills",
      "path": ".agent-skills/github-repo-candidate-quality-gate/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/akillness/jeo-skills/blob/HEAD/.agent-skills/github-repo-candidate-quality-gate/SKILL.md",
      "key": "akillness/jeo-skills/.agent-skills/github-repo-candidate-quality-gate/SKILL.md"
    },
    "allowed_tools": [
      "Bash",
      "Read",
      "Write",
      "Grep",
      "Glob"
    ],
    "license": "MIT"
  },
  "instructions": "# GitHub Repo Candidate Quality Gate\n\nUse this skill when broad GitHub search output is too noisy for merge-ready recommendations.\n\n## When to use\n- You already ran `gh search repos` (or equivalent) and need recommendation-grade keeps.\n- You must preserve broad discovery evidence while filtering keeps deterministically.\n- You need lane-level status + degraded-cause reporting for unattended cron review.\n\n## Minimum keep metadata\nFor every kept candidate, capture all fields:\n- `full_name`\n- `url`\n- `license`\n- `pushed_at` (or `updated_at` fallback)\n- `archived`\n- `stars`\n- one-line fit rationale",
  "cost": {
    "context_tokens": 515
  }
}

Fetch it by URL: GET /api/v1/registry/akillness-jeo-skills-github-repo-candidate-quality-gate/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.