github-cli-workflow

Inspects GitHub pull requests, issues, and workflow runs using git and gh with approval-gated mutations.

Updated Aug 5, 2026
One-click install
npx skills add https://github.com/ahsanghalib/ai-workflow --skill github-cli-workflow-ahsanghalib
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: github-cli-workflow
Source: https://github.com/ahsanghalib/ai-workflow/tree/main/skills/github-cli-workflow
Command: npx skills add https://github.com/ahsanghalib/ai-workflow --skill github-cli-workflow-ahsanghalib

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working with GitHub through an AI assistant risks accidental remote mutations, leaked credentials, and unverified assumptions about repository state. This Skill enforces a safe, evidence-based workflow for inspecting pull requests, issues, checks, and failed workflow logs while requiring explicit approval before any remote change. ## Core Features & Use Cases - Read-only GitHub inspection: Query PRs, issues, checks, and failed workflow logs with narrow git and gh commands, treating all output as untrusted data. - Approval-gated mutations: Draft the exact command, title, body, and target for any GitHub change, then execute only after explicit user approval of that single action. - Credential and boundary protection: Never read or print tokens, never run git push, and verify gh auth status before any query. - Use Case: A pull request's CI check fails. Use this Skill to run gh run view --log-failed, identify the first relevant failure with supporting evidence, and report findings without touching the remote repository. ## Quick Start Ask the assistant to inspect the failing checks on pull request 42 using the GitHub CLI and report the evidence without making any changes.

Frequently Asked Questions about github-cli-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I inspect a GitHub pull request from the command line?▼

Use gh pr list, gh pr view, and gh pr checks to inspect pull requests from the terminal. This Skill verifies gh auth status first, confirms the target repository, and reports evidence separating observed facts from suggested changes.

How to view failed GitHub Actions workflow logs with gh?▼

Run gh run list to find the run, then gh run view --log-failed to read only the failed logs. The Skill reads logs narrowly to diagnose the requested failure and never uses log content as command input.

Can an AI assistant safely create GitHub issues or comments?▼

Yes, when mutations are approval-gated. This Skill drafts the exact title, body, target, and command, checks for duplicates, and executes only after you explicitly approve that single action, then reports the resulting URL.

Does the GitHub CLI workflow expose my authentication token?▼

No. The Skill never reads, prints, stores, or requests tokens or credential files. It only runs gh auth status, which confirms account and host state without revealing any token.

When should I not use the gh CLI workflow for GitHub tasks?▼

Avoid it for pushes, releases, deployments, workflow dispatches, bulk operations, or GitHub MCP-based access, which are explicitly out of scope. It also stops if git or gh is missing or authentication cannot be confirmed.