# Supergithub

> Gerenciador avançado de repositórios GitHub via API REST. Use para: listar, arquivar, deletar, criar, atualizar repositórios e gerenciar topics. Suporta operações em lote. Ideal para automação de manutenção de repositórios, cleanup, padronização de topics e organização de projetos GitHub.

- Skill: `prof-ramos/supergithub` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add prof-ramos/supergithub`
- Raw SKILL.md: https://api.skillmd.com/api/skills/prof-ramos/supergithub/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- License: MIT
- Author: prof-ramos (https://skillmd.com/u/prof-ramos)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/prof-ramos/supergithub

---


# SuperGitHub - GitHub Repository Manager

Ferramenta Python para gerenciar repositórios GitHub via API REST com operações avançadas em lote.

## Funcionalidades

- **Listar**: repositórios com filtros avançados
- **Arquivar/Desarquivar**: repositórios
- **Deletar**: repositórios (com confirmação de segurança)
- **Criar**: novos repositórios
- **Atualizar**: configurações (nome, descrição, visibilidade)
- **Topics**: gerenciar tags/categorias
- **Lote**: operações em múltiplos repositórios

## Pré-requisitos

```bash
# Verificar Python
python3 --version

# Instalar dependências
pip install requests
```

## Configuração

```bash
# Criar token em: https://github.com/settings/tokens
# Permissões: repo, delete_repo
export GH_TOKEN='ghp_seu_token_aqui'
```

## Uso via CLI

```bash
# Listar repositórios
python gh_cli.py list --details

# Arquivar repositório
python gh_cli.py archive usuario repo-name

# Deletar com confirmação
python gh_cli.py delete usuario repo-name --yes

# Atualizar descrição
python gh_cli.py update usuario repo-name --description "Nova descrição"

# Gerenciar topics
python gh_cli.py topics add usuario repo-name --topics "python,automation"
```

## Uso como Biblioteca

```python
from github_repo_manager import GitHubRepoManager

gh = GitHubRepoManager()  # Usa GH_TOKEN do ambiente

# Listar repos
repos = gh.list_repos(per_page=10)

# Arquivar
gh.archive_repo("usuario", "repo-antigo")

# Deletar (requer confirm=True)
gh.delete_repo("usuario", "repo-teste", confirm=True)
```

## Scripts Disponíveis

| Script | Descrição |
|--------|-----------|
| `gh_cli.py` | CLI interativo completo |
| `github_repo_manager.py` | Biblioteca Python core |
| `workflow_organizer.py` | Automação de organização |
| `setup.sh` | Script de instalação |

Consulte [README.md](./README.md) para documentação completa.