Habilidade Kirito14IT/stargazer-atlas

O que stargazer-atlas faz?

Habilidade para o Codex que constrói páginas de atlas de stargazers do GitHub com preservação de privacidade e fluxos de implantação no GitHub Pages.

Visão geral

Esta habilidade permite que você crie uma página web interativa que exibe um mapa com as localizações aproximadas dos stargazers de qualquer repositório público do GitHub. A privacidade é priorizada: nenhum dado individual identificável é mostrado; apenas estatísticas agregadas e pontos geográficos anônimos.

Funcionalidades

• Preservação de privacidade: Usa geocodificação reversa para converter coordenadas precisas em cidades/regiões, exibindo apenas pontos agregados.
• Deploy automático: Configura um fluxo de trabalho do GitHub Actions para construir e implantar a página no GitHub Pages.
• Customizável: Permite especificar o repositório alvo, filtrar stargazers e ajustar o estilo do mapa.
• Suporte para múltiplos agentes: Funciona com Codex, Claude Code, Cursor e outros agentes de IA que suportem skills.

Como usar

1. Inicialize o projeto: Execute atlas init para configurar a estrutura de diretórios e templates.
2. Configure o repositório: Edite o arquivo config.yml com o nome do repositório alvo (ex.: usuario/repositorio).
3. Gere o atlas: Use atlas build para buscar os stargazers, processar as localizações e gerar a página HTML.
4. Implante: Execute atlas deploy ou faça commit do diretório docs/ para ativar o GitHub Pages.

Requisitos

• Um token de acesso pessoal do GitHub com escopo public_repo (ou repo para repositórios privados).
• Node.js 18+ (para scripts locais) ou GitHub Actions (para deploy automático).

Exemplo de configuração

# config.yml
repository: "facebook/react"
output: "docs/"
privacy_level: "city"  # city, region, country
max_points: 500
map_style: "light"

Fluxo de trabalho do GitHub Actions

O arquivo .github/workflows/atlas-deploy.yml é gerado automaticamente. Ele:

1. Agenda execuções semanais (ou manualmente via workflow_dispatch).
2. Busca novos stargazers.
3. Reconstrói o atlas.
4. Faz deploy para o branch gh-pages.

Estrutura de saída

docs/
├── index.html
├── assets/
│   ├── map.js
│   ├── style.css
│   └── data.json
└── README.md

Personalização

Você pode modificar:

• Tema do mapa: light, dark, satellite.
• Nível de privacidade: city (padrão), region, country.
• Limite de pontos: máximo de stargazers a exibir.
• Título e descrição: editáveis no arquivo index.html gerado.

Contribuições

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests no repositório original.