termux-oracle

name	termux-oracle
description	Conocimiento experto sobre Termux (Linux en Android), i-HakLab y sus más de 190 herramientas. El agente usa esta skill para comprender el entorno Android/Termux, configurar i-HakLab, instalar herramientas correctamente (apt/pip/npm/gem/glibc), resolver limitaciones de Android (Bionic vs glibc, proot, root) y guiar al usuario en el uso del ecosistema.
allowed-tools	["Bash(read:termux-oracle/*, detect-env, apt, pkg, i-Haklab, pip, npm)","Read","Glob","Grep","WebSearch","WebFetch"]

Termux-Oracle Skill

Contexto completo del ecosistema Termux/Android/i-HakLab para agentes de IA.

1. Detección del entorno

Al iniciar, ejecuta scripts/detect-env.sh para conocer el entorno actual:

bash ~/.agents/skills/termux-oracle/scripts/detect-env.sh

Esto retorna JSON con: termux_native, proot_distro, ssh, ihaklab_installed, wrapper_apt, glibc_repo, arch.

2. Contexto del entorno

Android + Termux

• Android usa Bionic libc (no GNU glibc). Los binarios Linux precompilados no funcionan sin adaptación.
• Termux corre como app de usuario sin root por defecto.
• $PREFIX = /data/data/com.termux/files/usr
• El gestor de paquetes es pkg (wrapper de apt con auto-refresh de repos).
• REGLAS:
  • Usa pkg install para instalaciones individuales (evita errores 404).
  • apt update && apt upgrade solo para mantenimiento general.
  • NO mezcles fuentes de instalación de apps Termux (GitHub/F-Droid/Play Store).

i-HakLab

• Suite que convierte Termux en un laboratorio portátil de ciberseguridad, desarrollo y automatización.
• Instala wrappers en ~/.local/bin/ (apt, npm, pnpm) que redirigen paquetes Python/Node/Ruby.
• Usa Fish shell por defecto, permite bash/zsh.
• Incluye ~190 herramientas documentadas en docs/recursos/herramientas/.

3. Routing por intención

El usuario pregunta sobre...	Archivo de referencia	Docs relacionadas
Instalar/configurar Termux	references/termux-setup.md	docs/termux/instalacion.md, docs/termux/configuracion.md
Paquetes, repos, pkg vs apt	references/termux-setup.md	docs/termux/paquetes.md
i-HakLab, comandos, wrappers	references/ihaklab.md	docs/recursos/herramientas-ihaklab.md
Cómo instalar herramienta X	references/tool-install.md	docs/recursos/herramientas/{tool}.md
Adaptación glibc, binarios rotos	references/android-limitations.md	docs/termux/compilacion-glibc.md
proot, udocker, docker-qemu	references/docker-alternatives.md	docs/android/bypass-limitaciones.md
Python, pip, compilación, venv	references/python-ecosystem.md	docs/termux/python.md, docs/termux/paquetes.md#6
ADB, depuración inalámbrica	references/android-limitations.md	docs/android/adb.md, docs/android/wireless-debugging.md
termux-packages (repo Ivam3)	references/tool-install.md	docs/recursos/termux-packages.md
Escritorio gráfico, X11, XFCE	references/termux-setup.md	docs/termux/termux-x11.md
Wrapper apt/npm/pnpm	references/ihaklab.md	docs/recursos/herramientas-ihaklab.md#13
Error de compilación/instalación	references/python-ecosystem.md	docs/termux/troubleshooting.md, docs/termux/fixer.md

4. Conceptos clave inline

pkg vs apt

• pkg install = apt update implícito + apt install. Usar para instalaciones individuales.
• apt install = no hace apt update automático. Usar solo si se acaba de hacer apt update.
• En i-HakLab, apt es un wrapper que puede redirigir a pip/npm/gem.

Wrappers i-HakLab

• ~/.local/bin/apt: Si detecta módulo Python → pip install. Si detecta módulo Node → npm install -g. Si es nativo → delega a $PREFIX/bin/apt.
• ~/.local/bin/npm: Normaliza alias (gemini-cli → @google/gemini-cli), automatiza n8n, pnpm, open-lovable.
• Post-instalación: pkg2conf aplica configuraciones (parches, symlinks, servicios).

Adaptación glibc

• Patrón: binario real renombrado .va39 + loader C que apunta a $PREFIX/glibc/lib/ld-linux-aarch64.so.1.
• Usado por: claude-code, opencode, codebuff, freebuff, mimocode, mistral-vibe.

Docker alternatives

• udocker: contenedores Docker en espacio de usuario (no requiere root).
• termux-docker-qemu: VM Alpine vía QEMU (root real dentro de la VM).
• proot: fake root (reescribe syscalls, limitado).

5. Reglas de ejecución

1. Siempre preferir pkg install sobre apt install para instalaciones individuales.
2. Si el usuario no tiene i-HakLab, usar pip install/npm install -g directamente.
3. Si el usuario tiene i-HakLab, apt install <tool> funciona (wrapper).
4. Para herramientas Python con dependencias C, verificar primero si existe python-<nombre> en apt.
5. Para herramientas glibc, instalar desde ivam3/termux-packages.
6. No recomendar --break-system-packages sin antes ofrecer venv como alternativa.
7. Si un comando falla, sugerir ejecutar fixer (diagnóstico automático).

6. Base de conocimiento adicional

Todo el conocimiento detallado está en /data/data/com.termux/files/.repositories/termux-oracle/docs/:

• termux/ — 13 archivos sobre instalación, paquetes, Python, glibc, troubleshooting, etc.
• android/ — 5 archivos sobre ADB, Fastboot, seguridad, bypass de limitaciones.
• recursos/ — manual i-HakLab (~970 líneas), 190+ tool docs individuales.
• scripts/, laboratorios/, ctf/, glosario/, comunidad/.

Usa Glob y Grep para buscar en estos archivos cuando necesites información específica que no esté en las referencias.