Github Issues

GitHub Issues Management

This skill provides instructions for managing GitHub issues directly from the terminal using the gh command-line tool.

Key Commands

1. Listing Issues

To list open issues in the current repository:

gh issue list

Options:

• --limit <number>: Limit the number of issues (default 30).
• --label <label>: Filter by label.
• --assignee <user>: Filter by assignee.
• --search <query>: Search issues with a query.
• --state <all|closed|open>: Filter by state.

2. Viewing Issue Details

To view a specific issue:

gh issue view <issue-number>

To view it in the browser:

gh issue view <issue-number> --web

3. Creating Issues

To create a new issue interactively:

gh issue create

To create an issue with title and body:

gh issue create --title "Issue Title" --body "Issue Body"

4. Adding Comments

To add a comment to an issue:

gh issue comment <issue-number> --body "Your comment here"

5. Managing State

To close an issue:

gh issue close <issue-number>

To reopen an issue:

gh issue reopen <issue-number>

6. Editing Issues

To add labels or assignees:

gh issue edit <issue-number> --add-label "bug" --add-assignee "@me"

Best Practices

• Always check the current status of the repository with gh issue list before creating new ones to avoid duplicates.
• Use descriptive titles and detailed bodies for new issues.
• When working on an issue, assign it to yourself to avoid overlapping work.
• Use gh issue status to see a summary of issues relevant to you.

Source: orbat-mapper/orbat-mapper — distributed by TomeVault.