
Skill
github-management
manage GitHub repository labels and projects
Description
Manage repository labels, milestones, and GitHub Projects V2 safely through the scoped GitHub App credential. Use for requests to list, create, edit, delete, assign, or move GitHub management resources.
SKILL.md
GitHub Management
<mutation_policy>
- Read-only requests run without confirmation.
- Creations and additive actions run directly. This includes creating labels or milestones and adding labels to an issue or pull request.
- Before a destructive change, read the current state, show the exact proposed change, and use
request_user_inputto obtain an explicit confirmation. Destructive changes are editing or deleting a label or milestone, replacing labels, assigning or clearing a milestone, and updating a project Status value. - Before deletion, show the exact resource name and URL as part of that confirmation. Do not infer confirmation from a broad request or a prior confirmation for another operation.
- If the requested payload changes after preflight, discard the prior confirmation and repeat the preflight.
- After a write, read back the affected resource and report its URL and resulting state. The task conversation is the audit record; do not create a database audit record.
- Encode user-controlled path segments and pass user values through
gh apifields or quoted arguments. Never interpolate them into executable shell fragments. </mutation_policy>
<projects_v2>
- Use
gh api graphqlto discover organization projects, project fields, project items, and single-select option IDs. Do not assume a board schema or column position. - Resolve the requested project and field by name. The default field is
Statusonly when it is a single-select field with that exact name. When a project or field is ambiguous, list the choices and ask the user to select one. - Locate the issue or pull request's existing item. If it is not in the project, report that fact instead of adding it.
- Before calling
updateProjectV2ItemFieldValue, show the project, field, current value, requested option, and item, then obtain confirmation. After confirmation, read back and report the project URL and final value. - When GitHub returns a missing permission error, explain that the GitHub App needs Organization projects access and the installation owner must approve the updated permission. Do not report the project as missing. </projects_v2>
<saved_views_capability_check> Before adding any native saved-view command, verify the exact GitHub endpoint, resource ownership, response URL, and whether an installation token can list, create, and delete the resource. Also verify whether the existing linked-account OAuth scope is sufficient. Task sandboxes intentionally use only scoped installation tokens, so do not inject a linked user's broader OAuth token into the sandbox. If the check fails, keep native views unavailable and offer a clearly labeled issue-search URL only as a non-persistent fallback. </saved_views_capability_check>
<completion_criteria>
- Every destructive mutation had the appropriate preflight and explicit confirmation; every write had a read-back.
- The response includes the resulting GitHub URL or explains the concrete permission/capability blocker.
- No operation used a broader credential or an unsupported saved-view API. </completion_criteria>
More skills from the Roomote repository
View all 33 skillsaddress-pr-feedback
address unresolved GitHub PR feedback
Jul 19Code ReviewGitHubPull Requestsagent-browser
automate browser interactions for agents
Jul 16Browser AutomationCLITestingcapture-visual-proof
capture visual proof of browser tasks
Aug 1AutomationBrowser AutomationScreenshotsci-failure-triage
triage failed CI workflows
Jul 23CI/CDDebuggingGitHub Actionscode-quality-auditor
audit code quality in merged pull requests
Jul 26Code AnalysisCode ReviewQAcodeql-triage
triage and remediate CodeQL security alerts
Jul 29Code AnalysisCodeQLDebuggingGitHub +2
More from Roo Code
View publishercreate-draft-pr
create draft pull requests
Roomote
Jul 16AutomationGitHubPull Requestscreate-pr
create pull requests for pending changes
Roomote
Jul 16GitHubPull Requestsdebug-reported-bug
reproduce and debug reported bugs
Roomote
Jul 16DebuggingGitTestingdependabot-triage
triage GitHub Dependabot alerts
Roomote
Jul 29AutomationGitHubSecurityTriageenvironment-setup
configure local development environments
Roomote
Aug 1ConfigurationLocal Developmentexplain-repo-code
explain repository code and architecture
Roomote
Jul 16Code AnalysisDocumentation