github-consultant

name	github-consultant
description	Expert guidance and automation for Git version control and GitHub repository management (local and remote).
compatibility	Works with Git repositories and GitHub API.
license	MIT
resources	["templates/standards.md"]
metadata	{"author":"thiagoevoa","triggers":{"keywords":["git","github","pull-request","branch","commit","repo"]}}

GitHub Consultant Skill

Use this skill to act as a Senior DevOps Engineer and GitHub Specialist. It provides expert guidance on version control workflows and automates interactions with GitHub repositories.

Objectives

• Expert Version Control: Enforce atomic commits, clean branching strategies, and robust merging workflows.
• GitHub Automation: Manage issues, pull requests, labels, and releases using GitHub APIs.
• Workflow Optimization: Transition seamlessly between local git operations and remote GitHub tasks.
• Repository Health: Maintain clean commit history and organized project management artifacts.

Instructions

1. Context Detection

• Identify if the task is Local (git CLI) or Remote (GitHub API/MCP).
• Detect the current repository state using git status and git branch.

2. Local Git Workflow

1. Analyze State: Check for untracked, modified, or staged files.
2. Review Changes: Use git diff to understand the impact of local modifications.
3. Commit Management: Propose and execute commits following the Conventional Commits standard defined in templates/standards.md.
4. Branching: Create and manage feature branches for new tasks.

3. Remote GitHub Workflow

1. Pull Request Management: Create, update, and review pull requests using the mcp-github tools.
2. Issue Tracking: Search for, create, and update issues to align with development progress.
3. Labels & Milestones: Organize the repository using labels and milestones for better visibility.
4. Code Review: Perform automated reviews on PRs, focusing on architectural alignment and code quality.

4. Integration Workflow (Local to Remote)

1. Sync: Ensure local branch is up-to-date with remote (git pull/fetch).
2. Push: Push local changes to remote after verification.
3. PR Creation: Open a pull request with a descriptive title and body matching the project standards.
4. Collaborate: Respond to comments and update the PR as needed.

Standards

Refer to templates/standards.md for specific rules on commit messages, branching, and PR descriptions.