smithery/arbgjr

github-sync

Skill base para sincronizacao com GitHub. Gerencia issues, labels e milestones de forma automatica. Use quando: criar issues, sincronizar milestones, gerenciar labels SDLC.

Installation

$ npx skills add smithery/arbgjr --skill github-sync

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from smithery/arbgjr.

npx skills add smithery/arbgjr

Browse all from smithery/arbgjr

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Skill metadata

Parsed from SKILL.md frontmatter.

Version1.0.0
Allowed toolsRead, Write, Bash, Glob
Declared agents claude-code

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 4,952 B
  • docs SUMMARY.md 193 B

History

  1. First recorded snapshot · 0 installs

SKILL.md

GitHub Sync Skill

Skill base que fornece utilitarios para sincronizacao com GitHub Issues, Labels e Milestones.

Objetivo

Prover uma camada de abstracao sobre a API do GitHub para que outros agentes e skills possam gerenciar issues, labels e milestones de forma consistente e automatizada.

Scripts Disponiveis

label_manager.py

Gerencia labels SDLC no repositorio.

# Criar todos os labels SDLC se nao existem
python3 .claude/skills/github-sync/scripts/label_manager.py ensure

# Listar labels existentes
python3 .claude/skills/github-sync/scripts/label_manager.py list

# Verificar se labels SDLC existem
python3 .claude/skills/github-sync/scripts/label_manager.py check

Labels criados:

  • phase:0 a phase:8 - fase atual do SDLC
  • complexity:0 a complexity:3 - nivel de complexidade
  • type:story, type:task, type:epic - tipo de item
  • sdlc:auto - criado automaticamente pelo SDLC

milestone_sync.py

Gerencia milestones (sprints) no repositorio.

# Criar milestone
python3 .claude/skills/github-sync/scripts/milestone_sync.py create \
  --title "Sprint 1" \
  --description "Sprint goal" \
  --due-date "2026-01-28"

# Fechar milestone
python3 .claude/skills/github-sync/scripts/milestone_sync.py close --title "Sprint 1"

# Listar milestones
python3 .claude/skills/github-sync/scripts/milestone_sync.py list

# Obter milestone por titulo
python3 .claude/skills/github-sync/scripts/milestone_sync.py get --title "Sprint 1"

issue_sync.py

Gerencia issues com integracao SDLC.

# Criar issue com labels SDLC
python3 .claude/skills/github-sync/scripts/issue_sync.py create \
  --title "[TASK-001] Implementar feature X" \
  --body-file task.md \
  --phase 5 \
  --type task \
  --milestone "Sprint 1"

# Atualizar issue
python3 .claude/skills/github-sync/scripts/issue_sync.py update \
  --number 123 \
  --phase 6 \
  --state open

# Sincronizar task YAML para issue
python3 .claude/skills/github-sync/scripts/issue_sync.py sync-task \
  --task-path .agentic_sdlc/projects/xxx/tasks/task-001.yml

# Buscar issue por titulo
python3 .claude/skills/github-sync/scripts/issue_sync.py find --title "[TASK-001]"

Mapeamento SDLC <-> GitHub

SDLC Agentico GitHub
Sprint Milestone
Sprint goal Milestone description
Sprint end date Milestone due_on
Task Issue
Story Issue (type:story)
Epic Issue (type:epic)
Phase Label (phase:N)
Complexity Label (complexity:N)

Labels por Cor

Label Cor Descricao
phase:0 #0E8A16 Preparation
phase:1 #1D76DB Discovery
phase:2 #5319E7 Requirements
phase:3 #FBCA04 Architecture
phase:4 #F9D0C4 Planning
phase:5 #C5DEF5 Implementation
phase:6 #BFD4F2 Quality
phase:7 #D4C5F9 Release
phase:8 #0052CC Operations
complexity:0 #C2E0C6 Quick Flow
complexity:1 #FEF2C0 Feature
complexity:2 #F9D0C4 BMAD Method
complexity:3 #E99695 Enterprise
type:story #D93F0B User Story
type:task #0075CA Task
type:epic #7057FF Epic
sdlc:auto #EDEDED Auto-generated

Integracao com Outros Skills

Esta skill e usada por:

  • github-projects - Para criar issues e adicionar ao project
  • orchestrator - Para sincronizar estado do SDLC com GitHub
  • delivery-planner - Para criar milestones de sprints

Pre-requisitos

  • GitHub CLI (gh) instalado e autenticado
  • Permissoes de escrita no repositorio
  • Scope project para integracao com Projects V2
# Verificar autenticacao
gh auth status

# Adicionar scope project se necessario
gh auth refresh -s project

Exemplos de Uso

Preparar repositorio para SDLC

# 1. Criar labels
python3 .claude/skills/github-sync/scripts/label_manager.py ensure

# 2. Criar primeiro milestone
python3 .claude/skills/github-sync/scripts/milestone_sync.py create \
  --title "Sprint 1" \
  --description "Inicio do projeto" \
  --due-date "$(date -d '+14 days' +%Y-%m-%d)"

Criar issue para task

python3 .claude/skills/github-sync/scripts/issue_sync.py create \
  --title "[TASK-001] Implementar autenticacao" \
  --body "## Descricao\n\nImplementar sistema de autenticacao OAuth2.\n\n## Acceptance Criteria\n\n- [ ] Login funcional\n- [ ] Logout funcional" \
  --phase 5 \
  --type task \
  --milestone "Sprint 1"

Transicao de fase

# Atualizar issue para nova fase
python3 .claude/skills/github-sync/scripts/issue_sync.py update \
  --number 123 \
  --phase 6