Github Issue Workflow

The github-issue-workflow skill enables AI agents to interact directly with GitHub Issues, allowing them to create new tasks, update existing ones, and manage workflows within a repository. It bridges the gap between code development and project management by automating issue lifecycle operations.

When to use it

• Automatically generating detailed bug reports from error logs or user feedback.
• Updating issue statuses (e.g., moving from "Open" to "In Progress") when code is committed.
• Assigning specific issues to team members based on skill sets or workload.
• Closing resolved issues and adding resolution comments after successful deployments.

Key capabilities

• Create new GitHub Issues with custom titles, descriptions, and labels.
• Update existing Issue status, assignees, and priority levels.
• Add comments to Issues to provide context or request additional information.
• Close Issues once tasks are completed or deemed invalid.

Example prompts

• "Create a high-priority issue titled 'Fix login timeout' in the main repository with labels 'bug' and 'authentication'."
• "Update issue #42 to assign it to @dev-team and change the status to 'In Progress'."
• "Close issue #15 and add a comment stating that the fix has been merged into the main branch."

Tips & gotchas

Ensure the AI agent has valid GitHub authentication tokens with sufficient permissions (e.g., repo scope) to perform write operations on issues. This skill is most effective when integrated into a broader CI/CD pipeline or automated testing workflow where issue creation is triggered by specific events.