spillwavesolutions/agent_rulez/mastering-github-cli
- community
Checking that the SKILL.md file is still in the repository.
GitHub CLI (gh) command reference for repository search, code discovery, CI/CD monitoring, workflow authoring, and automation. Triggers on "gh" commands, "github cli", searching repos for files/directories (.skilz, .cursor, .codex, Dockerfile), monitoring GitHub Actions workflows, checking PR CI status, downloading artifacts, creating PRs/issues/repos from command line, triggering workflows, forking repos, batch operations, "write a workflow", "github actions", "CI/CD pipeline", "workflow yaml", and "matrix builds". Use for gh search, gh run, gh pr, gh issue, gh repo, gh workflow, gh api, workflow authoring, and automating GitHub operations.
Install
npx vskill@latest install spillwavesolutions/agent_rulez/mastering-github-cliSKILL.md
Mastering GitHub CLI
Command-line interface for GitHub operations: search, monitoring, resource creation, workflow authoring, and automation.
Contents
Quick Start
Find repos with specific files/directories
Monitor CI/CD
Create resources
Trigger and monitor workflow
Command Reference
| Task | Command | Reference | |
|---|---|---|---|
| Find repos with file | gh search code --filename FILE | search.md | |
| Find repos with directory | gh search code "path:DIR" | search.md | |
| List failed runs | gh run list --status=failure | monitoring.md | |
| Watch run | gh run watch ID --exit-status | monitoring.md | |
| Download artifacts | gh run download ID -n NAME | monitoring.md | |
| Create PR | gh pr create --fill | resources.md | |
| Check PR CI | gh pr checks --watch | monitoring.md | |
| Trigger workflow | gh workflow run NAME.yml | automation.md | |
| Fork repo | gh repo fork REPO --clone | resources.md | |
| REST/GraphQL API | gh api repos/{owner}/{repo} | api.md |
JSON Output
Environment & Auth
| Variable | Purpose | |
|---|---|---|
GH_TOKEN | Authentication token | |
GH_REPO | Default owner/repo | |
GH_HOST | GitHub Enterprise host | |
GH_PROMPT_DISABLED=1 | Disable prompts (CI) |
Rate Limits
| Endpoint | Limit | Notes | |
|---|---|---|---|
| REST API | 5,000/hour | Per authenticated user | |
| Search API | 30/minute | All search endpoints | |
| Code Search | 10/minute | More restrictive | |
| Search results | 1,000 max | Use date partitioning for more |
Workflow Authoring
GitHub Actions workflow YAML patterns for CI/CD pipelines.
Basic Structure
Caching Patterns
Matrix Builds
OIDC Authentication (AWS/GCP)
Full reference: references/workflow-authoring.md
Advanced Patterns
For enterprise CI/CD pipelines:
- Ephemeral PR Environments - Auto-create/destroy per PR
- Release Please - Automated semantic versioning
- PR Cleanup - Resource cleanup on close
- Testing Patterns - pytest, Gradle, Jest with coverage
- Deployment Status Checks - Wait for stack readiness
- Separate Build/Deploy Roles - Fine-grained OIDC permissions
- Multi-Stack Ordering - Foundation → Schemas → Application
Additional References:
- Workflow Summaries - Rich markdown output with $GITHUB_STEP_SUMMARY
- Container Security - Multi-stage builds, Trivy scanning, image tagging
- Security Scanning - CodeQL, Dependabot, IaC scanning (Checkov, tfsec)
- Troubleshooting - Debug mode, flaky tests, common issues
- Performance - Limits, runner specs, optimization tips
Scripts
Pre-built automation scripts with error handling and rate limit awareness.
| Script | Purpose | Usage | |
|---|---|---|---|
find-repos-with-path.sh | Find repos containing specific paths | ./scripts/find-repos-with-path.sh .skilz [owner] | |
wait-for-run.sh | Block until workflow completes | ./scripts/wait-for-run.sh RUN_ID [timeout] | |
batch-search.sh | Search >1000 results via date partitioning | ./scripts/batch-search.sh "query" START END |
Exit Codes
| Script | 0 | 1 | 2 | 3 | |
|---|---|---|---|---|---|
wait-for-run.sh | success | failure | cancelled | timeout | |
find-repos-with-path.sh | success | error | - | - | |
batch-search.sh | success | error | - | - |
Validation Checklist
Before completing a GitHub CLI task, verify:
When Not to Use
This skill covers gh CLI and GitHub Actions workflow authoring. Do not use for:
- Git commands:
git push,git commit,git pull(use git directly) - GitHub web UI: Questions about github.com interface navigation
- GitHub Desktop: Different application entirely
- Direct curl/HTTP: API calls without
ghwrapper - GitHub mobile app: Mobile-specific features
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryChecking.skilz/skills/mastering-github-cli/SKILL.md
Popularity
- Repository stars
- 34
- Repository forks
- 8
- 7-day trend score
- 18
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 25 Mar 2026, 7 months ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/spillwavesolutions/agent_rulez/mastering-github-cli)