Agent skill
gh-cli
Use when interacting with GitHub - searching for repos/orgs/packages, exploring codebases, finding projects to use, querying branches/PRs/issues/releases/workflows, automating GitHub operations, or when users mention GitHub organizations or repositories
Install this agent skill to your Project
npx add-skill https://github.com/mathiassoeholm/dotfiles/tree/main/opencode/.config/opencode/skill/gh-cli
SKILL.md
CRITICAL: You MUST use the Task tool with
subagent_type: "general"to execute GitHub CLI commands. NEVER runghcommands directly in your bash session.
Example Task invocation:
Task(subagent_type="general", prompt="Use gh CLI to list branches: gh branch list --json name,updatedAt")
This preserves conversation context and isolates CLI output.
GitHub CLI (gh)
Command-line interface for GitHub. Use --json <fields> with --jq for scriptable output.
Quick Reference
| Task | Command |
|---|---|
| List my PRs | gh pr list --author @me |
| View PR | gh pr view <number> |
| Create PR | gh pr create --fill |
| Checkout PR | gh pr checkout <number> |
| List issues | gh issue list |
| View issue | gh issue view <number> |
| Create issue | gh issue create --title "..." --body "..." |
| Repo info | gh repo view |
| Clone repo | gh repo clone <owner/repo> |
| List releases | gh release list |
| Workflow runs | gh run list |
| View run | gh run view <run-id> |
| Search repos | gh search repos <query> |
| Search code | gh search code <query> |
| API request | gh api <endpoint> |
| My status | gh status |
| Auth status | gh auth status |
Core Commands
| Command | Description |
|---|---|
gh repo |
Manage repositories (create, clone, fork, view, delete, edit) |
gh pr |
Manage pull requests (create, list, view, checkout, merge, close) |
gh issue |
Manage issues (create, list, view, edit, close, comment) |
gh release |
Manage releases (create, list, view, download, delete) |
gh gist |
Manage gists (create, list, view, edit, delete) |
gh project |
Work with GitHub Projects |
GitHub Actions
| Command | Description |
|---|---|
gh run list |
List recent workflow runs |
gh run view |
View a workflow run |
gh run watch |
Watch a run until completion |
gh run rerun |
Rerun a workflow |
gh workflow list |
List workflows |
gh workflow run |
Trigger a workflow |
gh cache list |
List Actions caches |
Additional Commands
| Command | Description |
|---|---|
gh search |
Search repos, issues, PRs, commits, code |
gh api |
Make authenticated API requests |
gh auth |
Manage authentication (login, logout, status) |
gh config |
Manage configuration |
gh secret |
Manage repository/org secrets |
gh variable |
Manage Actions variables |
gh label |
Manage issue labels |
gh ruleset |
View repository rulesets |
For detailed flags and examples, see pr-commands.md, issue-commands.md, repo-commands.md, actions-commands.md, and other-commands.md in this skill directory.
Output Flags
| Flag | Description |
|---|---|
--json <fields> |
Output JSON with specified fields |
-q, --jq <expr> |
Filter JSON output with jq expression |
-t, --template |
Format output with Go template |
-w, --web |
Open in browser |
Global Flags
| Flag | Description |
|---|---|
-R, --repo OWNER/REPO |
Select repository |
--help |
Help for any command |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
mathiassoeholm/dotfiles
ubiquitous-language
Extract a DDD-style ubiquitous language glossary from the current conversation, flagging ambiguities and proposing canonical terms. Saves to UBIQUITOUS_LANGUAGE.md. Use when user wants to define domain terms, build a glossary, harden terminology, create a ubiquitous language, or mentions "domain model" or "DDD".
mathiassoeholm/dotfiles
edit-article
Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.
mathiassoeholm/dotfiles
jira-cli
Use when querying or automating Jira - sprints, issues, epics, stories, boards, or correlating Jira data with external systems
mathiassoeholm/dotfiles
grill-me
Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".
mathiassoeholm/dotfiles
write-a-skill
Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.
mathiassoeholm/dotfiles
aws-cli
Use when interacting with AWS - managing S3, EC2, Lambda, IAM, CloudFormation, ECS/EKS, RDS, DynamoDB, CloudWatch, or any AWS service
Didn't find tool you were looking for?