Skill v1.0.1

currentAutomated scan100/100

joshmanders/dotfiles/github

1 files

──Details

PublishedMay 16, 2026 at 08:09 AM

Content Hashsha256:8020e28581fabf37...

Git SHAad3bc592c2c9

Bump Typepatch

Compare with v1.0.0

──Files

Files (1 file, 4.5 KB)

SKILL.md4.5 KBactive

SKILL.md · 257 lines · 4.5 KB

version: "1.0.1" name: github description: "GitHub CLI patterns for issues, projects, and PRs. Invoke when: creating issues, linking PRs to issues, updating project status, or any GitHub project operations." user-invocable: false

GitHub CLI Patterns

Generic patterns for GitHub operations using gh CLI.

Issues

Creating Issues

bash

gh issue create \
  --repo <org>/<repo> \
  --title "Issue title" \
  --body "## Summary
Description of what and why.
 
## Acceptance Criteria
- [ ] Criterion 1
- [ ] Criterion 2"

With project board:

bash

gh issue create \
  --repo <org>/<repo> \
  --title "Issue title" \
  --body "..." \
  --project "<project-name>"

Issue Operations

bash

# List issues
gh issue list --repo <org>/<repo>
 
# View issue
gh issue view <number> --repo <org>/<repo>
 
# Edit issue
gh issue edit <number> --repo <org>/<repo>
 
# Add comment
gh issue comment <number> --repo <org>/<repo> --body "..."
 
# Search across org
gh search issues --owner <org> "search terms"
 
# Get issue node ID (for GraphQL)
gh issue view <number> --repo <org>/<repo> --json id --jq '.id'

Project Boards (v2)

Adding to Project

bash

gh project item-add <project-number> --owner <org> \
  --url https://github.com/<org>/<repo>/issues/<number>
 
# List project items
gh project item-list <project-number> --owner <org>

Getting Project Item ID

Required for status updates:

bash

gh api graphql -f query='
query($url: URI!) {
  resource(url: $url) {
    ... on Issue {
      projectItems(first: 1) {
        nodes { id }
      }
    }
  }
}' -f url="https://github.com/<org>/<repo>/issues/<num>" --jq '.data.resource.projectItems.nodes[0].id'

Setting Status

bash

gh api graphql -f query='
mutation {
  updateProjectV2ItemFieldValue(input: {
    projectId: "<project-id>"
    itemId: "<project-item-id>"
    fieldId: "<status-field-id>"
    value: { singleSelectOptionId: "<status-option-id>" }
  }) {
    projectV2Item { id }
  }
}'

Setting Issue Type

bash

gh api graphql -f query='
mutation {
  updateIssue(input: {
    id: "<issue-node-id>",
    issueTypeId: "<issue-type-id>"
  }) {
    issue { title issueType { name } }
  }
}'

Pull Requests

Creating PRs

bash

gh pr create \
  --repo <org>/<repo> \
  --title "feat: short description" \
  --body "## Summary
What was done.
 
## Changes
- Change 1
- Change 2
 
Closes #<issue-number>"

PR Operations

bash

# List PRs
gh pr list --repo <org>/<repo>
 
# View PR
gh pr view <number> --repo <org>/<repo>
 
# Check PR status
gh pr checks <number> --repo <org>/<repo>

Linking PRs to Issues

Include in PR body to auto-close:

Closes #123
Fixes #123
Resolves #123

Cross-repo reference:

Closes <org>/<other-repo>#123

Reference without closing:

Related to #123

Sub-Issues

GitHub's native parent-child issue hierarchy for cross-repo coordination.

Adding Sub-Issues

bash

# Get parent issue ID
PARENT_ID=$(gh issue view <num> --repo <org>/<repo> --json id --jq '.id')
 
# Add sub-issue by URL
gh api graphql -f query="
mutation {
  addSubIssue(input: {
    issueId: \"$PARENT_ID\"
    subIssueUrl: \"https://github.com/<org>/<repo>/issues/<num>\"
  }) {
    issue { title }
    subIssue { title url }
  }
}"

Viewing Sub-Issues

bash

gh api graphql -f query='
query($url: URI!) {
  resource(url: $url) {
    ... on Issue {
      title
      subIssues(first: 10) {
        nodes {
          title
          url
          state
        }
      }
    }
  }
}' -f url="https://github.com/<org>/<repo>/issues/<num>"

Removing Sub-Issues

bash

# Get both issue IDs
PARENT_ID=$(gh issue view <parent-num> --repo <org>/<repo> --json id --jq '.id')
SUB_ID=$(gh issue view <sub-num> --repo <org>/<repo> --json id --jq '.id')
 
# Remove sub-issue
gh api graphql -f query="
mutation {
  removeSubIssue(input: {
    issueId: \"$PARENT_ID\"
    subIssueId: \"$SUB_ID\"
  }) {
    issue { title }
    subIssue { title }
  }
}"

Quick Reference

Action	Command
Create issue	`gh issue create --repo <org>/<repo> ...`
Add to project	`gh project item-add <num> --owner <org> ...`
List issues	`gh issue list --repo <org>/<repo>`
View issue	`gh issue view <num> --repo <org>/<repo>`
Search org	`gh search issues --owner <org> "query"`
Create PR	`gh pr create --repo <org>/<repo> ...`

← v1.0.0 All versions