Instalación

Cada skill es una carpeta con tres archivos: SKILL.md, mapa-web.md y fuentes.md. Se referencian entre sí por ruta relativa, así que la carpeta se copia entera, con su nombre intacto y sin subcarpetas propias. Una instalación en el destino neutral se ve así:

.agents/skills/navegar-anla/
├── SKILL.md
├── mapa-web.md
└── fuentes.md

Carpeta de destino

Sin un destino explícito, el instalador busca una carpeta existente en este orden: .agents/skills, .claude/skills y .opencode/skills. Si no encuentra ninguna, crea .agents/skills, destino neutral predeterminado. La instalación global aplica el mismo criterio dentro de la carpeta de usuario.

En Windows, ~ corresponde a $env:USERPROFILE.

Ruta 1 — Un comando, sin clonar

Abre una terminal en la carpeta de tu proyecto. El instalador no deja ningún repositorio al lado del tuyo.

En Windows, la primera línea prepara el instalador en la variable $po y la segunda instala el atlas. Si ya preparaste $po en esa misma terminal, basta la segunda línea.

Atlas de Navegación Ambiental de Colombia

Windows (PowerShell):

$po = [scriptblock]::Create((irm https://raw.githubusercontent.com/Nicolas9714/public-orbit/main/instalar.ps1).TrimStart([char]0xFEFF))
& $po -Atlas ambiental

macOS / Linux / Git Bash:

curl -fsSL https://raw.githubusercontent.com/Nicolas9714/public-orbit/main/instalar.sh | bash -s -- --atlas ambiental

Atlas de Navegación Minero Energético de Colombia

Windows (PowerShell):

$po = [scriptblock]::Create((irm https://raw.githubusercontent.com/Nicolas9714/public-orbit/main/instalar.ps1).TrimStart([char]0xFEFF))
& $po -Atlas minero-energetico

macOS / Linux / Git Bash:

curl -fsSL https://raw.githubusercontent.com/Nicolas9714/public-orbit/main/instalar.sh | bash -s -- --atlas minero-energetico

Qué instalar

Opciones adicionales

-Entidad busca cada nombre en todos los atlas, sin necesidad de indicar -Atlas. Al pedir dos o más atlas completos, el instalador agrega automáticamente atlas-orquestador-colombia, la skill que enruta las consultas entre sectores; con skills sueltas no se agrega, pero puedes pedirla por su nombre.

Ruta 2 — Descarga de un ZIP desde este sitio

Cada ficha de entidad y cada ficha de atlas ofrece un ZIP descargable. Se descomprime directamente dentro de la carpeta de skills de tu herramienta (ver tabla arriba). Basta un navegador y un descompresor: funciona en cualquier equipo, con cualquiera de las tres herramientas.

Los ZIP de atlas no incluyen atlas-orquestador-colombia: si vas a usar dos o más atlas, instala con el comando de la Ruta 1 en vez de combinar ZIP sueltos.

Ruta 3 — Desde un clon del repositorio

Clonar tiene sentido si vas a aportar al proyecto o prefieres actualizar las skills con git pull. Clónalo junto a tu proyecto:

git clone https://github.com/Nicolas9714/public-orbit.git

Desde ahí, el instalador local acepta las mismas opciones de la Ruta 1 y suma -Actualizar / --actualizar, que hace git pull antes de copiar:

# Windows (PowerShell)
..\public-orbit\instalar.ps1 -Atlas todos -Actualizar

# macOS / Linux / Git Bash
bash ../public-orbit/instalar.sh --atlas todos --actualizar

En Windows, si PowerShell responde que la ejecución de scripts está deshabilitada, habilítala para tu usuario con Set-ExecutionPolicy -Scope CurrentUser RemoteSigned, o usa la Ruta 1, que no depende de esa política.

También puedes copiar las carpetas manualmente, sin instalador. Para el atlas ambiental en la carpeta neutral:

# macOS / Linux / Git Bash
cp -r public-orbit/atlas/ambiental/skills/* .agents/skills/

# Windows (PowerShell)
Copy-Item -Recurse -Force `
  "public-orbit\atlas\ambiental\skills\*" `
  ".agents\skills\"

Cambia ambiental por minero-energetico para el otro atlas, y .agents\skills por .claude\skills u .opencode\skills si prefieres la carpeta de tu herramienta. Si instalas dos o más atlas, agrega también la orquestadora nacional:

cp -r public-orbit/atlas/nacional/skills/atlas-orquestador-colombia .agents/skills/

El clon queda como fuente, y la copia en tu carpeta de skills como instalación: son roles distintos. Para instalación global, usa la carpeta del usuario en vez del proyecto (~/.agents/skills/, ~/.claude/skills/, ~/.opencode/skills/).

Advertencia al reinstalar

Al reinstalar, cada skill solicitada se reemplaza de forma exacta, para retirar archivos obsoletos. Cualquier personalización que hayas hecho dentro de una carpeta instalada se pierde en ese reemplazo. Mantén tus personalizaciones fuera de la carpeta instalada, o respáldalas antes de reinstalar.