How do I install the Gh Run Failure skill?

Run npx skillmds@latest add tomevault-io/gh-run-failure in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Gh Run Failure skill do?

Use to analyze failures in GitHub pipelines or jobs. Use when this capability is needed. It is listed under Coding & Dev Tools on SkillMD.

Is Gh Run Failure safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gh Run Failure?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gh Run Failure free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Gh Run Failure?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gh Run Failure by tomevault-io — Agent Skill

Name: Gh Run Failure
Author: tomevault-io

File contents

List recent runs

Inspect a single run

Show only failed jobs or steps

View failed jobs/steps output

To focus on a specific job, first list them: gh run view "$RUN_ID" --json jobs --jq '.jobs[] | "(.databaseId)\t(.name)\t(.conclusion)"'

Then fetch that job's log: JOB_ID=987654321 gh run view "$RUN_ID" --job "$JOB_ID" --log

List artifacts from a run

Download a specific artifact

After downloading, search locally for errors: rg -n "error|fail|exception" /tmp/github-run-"$RUN_ID"

Compare failed and latest successful run

Get latest successful run ID: BRANCH=main OK=$(gh run list --branch "$BRANCH" --limit 50 --json databaseId,conclusion
--jq '.[] | select(.conclusion=="success") | .databaseId' | head -n1) echo "$OK"

Diff their SHAs: FAIL_SHA=$(gh run view "$RUN_ID" --json headSha --jq .headSha) OK_SHA=$(gh run view "$OK" --json headSha --jq .headSha) gh api repos/:owner/:repo/compare/"$OK_SHA"..."$FAIL_SHA" --jq '.commits[].commit.message' | sed 's/^/- /'

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: gh-run-failuredescription: Use to analyze failures in GitHub pipelines or jobs. Use when this capability is needed.---<general_guidelines>- Assume the `gh` tool is installed and configured.- Avoid printing full logs; focus on the failing step.- For large logs, prefer downloading artifacts.- If a test case failed, specify which test and how to run it locally.</general_guidelines>## List recent runs<example>gh run list --limit 20 --json databaseId,createdAt,headBranch,event,conclusion,status,displayTitle \ --template '{{range .}}{{printf "%8v %-20s %-8s %-10s %-10s %s\n" .databaseId .createdAt .status .conclusion .event .displayTitle}}{{end}}'</example>## Inspect a single run<example>RUN_ID=123456789gh run view "$RUN_ID" --json status,conclusion,createdAt,headSha,headBranch,event,workflowName,url</example>## Show only failed jobs or steps<example>gh run view "$RUN_ID" --json jobs --jq ' .jobs[] | select(.conclusion != "success") | .name as $job | (.steps[]? | select(.conclusion != "success") | "\($job) :: \(.name) :: \(.conclusion)")'</example>## View failed jobs/steps output<example>gh run view "$RUN_ID" --log-failed</example>To focus on a specific job, first list them:<example>gh run view "$RUN_ID" --json jobs --jq '.jobs[] | "\(.databaseId)\t\(.name)\t\(.conclusion)"'</example>Then fetch that job's log:<example>JOB_ID=987654321gh run view "$RUN_ID" --job "$JOB_ID" --log</example>## List artifacts from a run<example>gh run download "$RUN_ID" --list</example>## Download a specific artifact<example>gh run download "$RUN_ID" --name "test-logs" --dir /tmp/github-run-"$RUN_ID"</example>After downloading, search locally for errors:<example>rg -n "error|fail|exception" /tmp/github-run-"$RUN_ID"</example>## Compare failed and latest successful runGet latest successful run ID:<example>BRANCH=mainOK=$(gh run list --branch "$BRANCH" --limit 50 --json databaseId,conclusion \ --jq '.[] | select(.conclusion=="success") | .databaseId' | head -n1)echo "$OK"</example>Diff their SHAs:<example>FAIL_SHA=$(gh run view "$RUN_ID" --json headSha --jq .headSha)OK_SHA=$(gh run view "$OK" --json headSha --jq .headSha)gh api repos/:owner/:repo/compare/"$OK_SHA"..."$FAIL_SHA" --jq '.commits[].commit.message' | sed 's/^/- /'</example>---> Converted and distributed by [TomeVault](https://tomevault.io/claim/bkircher) — claim your Tome and manage your conversions.

Frequently asked questions

Gh Run Failure