CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gh-fix-ci

Use when a user asks to debug or fix failing GitHub PR checks that run in GitHub Actions. Uses `gh` to inspect checks and logs, summarize failure context, draft a fix plan, and implement only after explicit approval. Treats external providers (for example Buildkite) as out of scope and reports only the details URL. Do NOT use for addressing PR review comments (use gh-address-comments) or general CI outside GitHub Actions.

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable skill body: concrete copy-paste commands, a gated 8-step workflow with validation checkpoints and fallbacks, and clean one-level-deep disclosure to a real bundled script. The only notable weakness is repetition of the script invocation across three sections.

Suggestions

State the inspect_pr_checks.py invocation once (e.g., in Bundled Resources) and reference it from Quick start and Workflow step 3 instead of repeating the full command three times.

Drop the "Prereq: authenticate..." line from Overview since Workflow step 1 already covers auth verification and recovery in full.

DimensionReasoningScore

Conciseness

Efficient and assumes competence (no explanation of what gh or GitHub Actions is), but the script invocation `python "<path-to-skill>/scripts/inspect_pr_checks.py" --repo ... --pr ...` appears three times (Quick start, Workflow step 3, Bundled Resources) and the "Prereq: authenticate" line in Overview duplicates Workflow step 1. Minor trimming would get it to anchor 5.

4 / 5

Actionability

Fully executable commands throughout: `gh pr view --json number,url`, `gh pr checks <pr> --json name,state,bucket,link,...`, `gh run view <run_id> --log`, `gh api "/repos/<owner>/<repo>/actions/jobs/<job_id>/logs"`, plus a bundled script whose documented flags (--repo, --pr, --json, --max-lines, --context) match the actual argparse in scripts/inspect_pr_checks.py. Fallbacks for gh field drift and in-progress runs cover the common failure cases.

5 / 5

Workflow Clarity

Eight clearly sequenced steps with explicit validation and recovery: step 1 gates on `gh auth status` with recovery ("If unauthenticated, ask the user to run `gh auth login`"), step 3 has fallbacks for rejected fields and in-progress logs, step 6-7 gate implementation on explicit approval, and step 8 rechecks status after changes. Only a minor gap: step 8 suggests re-running rather than mandating an iterate-if-still-failing loop.

5 / 5

Progressive Disclosure

A lean ~70-line body with well-organized sections (Overview, Inputs, Quick start, Workflow, Bundled Resources) pointing to a single one-level-deep bundle file, scripts/inspect_pr_checks.py, which exists and matches the documented usage. Navigation is easy and nothing that belongs in a separate file is inlined.

5 / 5

Total

19

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: explicit what/when, concrete third-person actions, and well-drawn boundaries against adjacent skills (PR comments, non-GitHub-Actions CI, external providers). Only minor gap: a few natural trigger synonyms like "build failure" or "red CI".

DimensionReasoningScore

Specificity

Multiple concrete actions are listed in third person: "Uses `gh` to inspect checks and logs, summarize failure context, draft a fix plan, and implement only after explicit approval", plus explicit scope handling ("Treats external providers... as out of scope and reports only the details URL"). Coverage of the skill's behavior is comprehensive with no vague filler.

5 / 5

Completeness

Both halves are explicit: the "what" ("inspect checks and logs, summarize failure context, draft a fix plan, and implement only after explicit approval") and the "when" ("Use when a user asks to debug or fix failing GitHub PR checks that run in GitHub Actions"), reinforced by negative triggers ("Do NOT use for addressing PR review comments... or general CI outside GitHub Actions").

5 / 5

Trigger Term Quality

Good natural-term coverage: "debug or fix failing GitHub PR checks", "GitHub Actions", "CI" — phrases users would plausibly say. A few common variations are missing (e.g., "build failure", "red CI", "workflows"), so it sits between anchor 4 ("good keyword coverage; a few natural terms missing") and anchor 5.

4 / 5

Distinctiveness Conflict Risk

Clear niche (GitHub Actions PR check failures only) with explicit disambiguation from neighboring skills: "Do NOT use for addressing PR review comments (use gh-address-comments) or general CI outside GitHub Actions" and Buildkite excluded. Minimal conflict risk.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

tech-leads-club/agent-skills

Path

packages/skills-catalog/skills/(tooling)/gh-fix-ci/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.