Communitygithub.com

JordiRigau/hp-prime-kit

Kit HP Prime listo para agentes: archivo AGENTS.md con las reglas de PPL medidas en un G2 real, un linter, un intérprete que ejecuta el mismo código fuente que instalas, y un constructor de .hpprgm — para que un agente pueda escribir, verificar y empaquetar un programa sin tocar la calculadora.

¿Qué es hp-prime-kit?

Este kit resuelve los dos problemas principales al programar en PPL para la calculadora HP Prime: la documentación deficiente del lenguaje y el compilador que solo reporta 'error de sintaxis' con un número de línea. Proporciona un linter que explica los errores que el compilador no detalla, un intérprete que ejecuta el mismo archivo fuente que se instalará en la calculadora, y un constructor de binarios .hpprgm. El flujo de trabajo está diseñado para que un agente de IA (como Claude Code) pueda escribir código PPL, verificarlo con el linter, ejecutarlo localmente con el intérprete y empaquetarlo en un binario listo para arrastrar a la calculadora mediante el Connectivity Kit. Incluye también un archivo AGENTS.md que define el contrato operativo: qué leer antes de escribir PPL, las dos puertas que debe pasar cada programa, qué no debe afirmar el agente y qué solo puede hacer el humano. Soporta todos los comandos esenciales: lint, run, write, doctor, new, build y verify.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add JordiRigau/hp-prime-kit

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

HP Prime

PPL está mal documentado y su compilador solo dice error de sintaxis con un número de línea. Este kit elimina las dos cosas que más tiempo desperdician: adivinar la sintaxis y el ritual de copiar y compilar en el Connectivity Kit.

Comienza aquí

Lee AGENTS.md. Es el contrato operativo de este repositorio: qué leer antes de escribir PPL, las dos puertas por las que pasa cada programa, lo que no debes afirmar y lo que solo puede hacer el humano. Es breve, y todo lo que sigue lo presupone.

Luego lee docs/reference/ppl.md antes de escribir una línea — especialmente el §2, cuatro hipótesis que parecen razonables y son falsas.

El bucle, en tres comandos

hpprime lint ARCHIVO.txt                  # lo que el compilador no explicará
hpprime run  ARCHIVO.txt --call "F(2)"    # ejecuta el archivo real, aquí, sin calculadora
hpprime write ARCHIVO.txt -o PROG.hpprgm  # construye el binario

Luego el humano arrastra el .hpprgm sobre la calculadora en la ventana del Connectivity Kit. Tú no puedes hacer ese paso, y copiar en la carpeta espejo no funciona — docs/reference/deploy.md.

hpprime doctor comprueba la máquina, hpprime new NOMBRE escribe un iniciador que ya funciona, hpprime build crea una aplicación, hpprime verify verifica una. Todos los comandos están en docs/tools.md.

Si el usuario nunca ha programado una Prime

Enviarlo a docs/start/01-setup.md antes que nada. Es un camino de seis pasos desde una carpeta vacía hasta algo que funcione en la calculadora, y el paso 6 trata sobre trabajar contigo.

Instalando esta skill

git clone https://github.com/JordiRigau/hp-prime-kit ~/.claude/skills/hp-prime

El repositorio es la skill: SKILL.md está en su raíz, así que cualquier sesión que toque archivos .hpprgm o código PPL tiene las reglas medidas frente a ella en lugar de improvisar sintaxis.

Skills relacionados