Dale un compresor de imágenes a tu agente con PiPic Skill

Tu agente de programación puede ejecutar una build, editar un componente y arreglar un test fallido. Sin embargo, al pedirle que comprima una carpeta de imágenes suele escribir un script desechable o elegir una herramienta cuya salida no sabe interpretar de forma fiable. PiPic le ofrece otro camino: una CLI real hace el trabajo con las imágenes y una Skill breve enseña al agente a invocarla con seguridad.

PiPic no es un modelo de compresión con IA. El agente elige y opera la herramienta; la PiPic Agent CLI envía archivos PNG, JPEG, WebP o AVIF al mismo servicio de compresión alojado que usa la API HTTP. PiPic Skill es la capa de instrucciones que conecta una petición en lenguaje natural con ese comando.

Instala la CLI y la Skill una sola vez

La configuración corresponde a la persona que utiliza la máquina. Instala la CLI, aprueba un inicio de sesión y añade la Skill de código abierto a los agentes que uses:

npm i -g @pipic/cli
pipic login

npx skills add PiPic-cc/pipic-cli -g \
  -a claude-code \
  -a codex \
  -a cursor \
  -y

El comando corto npx skills add PiPic-cc/pipic-cli -g pregunta qué agentes compatibles deben recibir la Skill. Más adelante, npx skills update -g comprueba si hay actualizaciones para las Skills instaladas globalmente. El código de la Skill es público junto a la CLI, por lo que las reglas de operación se pueden inspeccionar y no están escondidas en un servicio de prompts.

Después, la petición no necesita mencionar el producto ni recordar opciones:

Compress the images in ./assets in place.

La descripción de la Skill coincide con peticiones para comprimir, reducir u optimizar imágenes. Una vez seleccionada, comprueba que pipic está instalado y que la máquina ha iniciado sesión. Luego traduce “in place” a --replace y ejecuta la CLI con una salida legible por máquinas:

pipic ./assets --replace --json

Si el usuario quiere conservar los originales, el agente utiliza -o <dir>. PiPic exige uno de esos dos destinos y rechaza un comando sin ninguno antes de enviar un solo archivo.

La Skill contiene las reglas que un agente no puede adivinar

Un README puede describir un comando, pero el agente todavía debe decidir qué cuenta como éxito, cuándo reintentar y cuándo detenerse. Esas decisiones afectan a los archivos y al cupo mensual, así que PiPic Skill las fija de forma explícita.

La Skill indica al agente que siempre solicite --json. La CLI escribe entonces un objeto NDJSON por archivo de entrada con seis campos fijos: file, status, before, after, saved y, en saltos o fallos, error. status solo admite ok, skipped y error.

skipped no es un fallo. Un motivo habitual es que el resultado comprimido fuera mayor, por lo que PiPic conservó el original. La Skill evita que el agente lo presente como una ejecución rota o que sustituya un buen archivo por otro más grande.

El código de salida determina la siguiente acción:

La regla del código 1 importa. Repetir un directorio completo después de que fallen dos archivos vuelve a subir todos los archivos que ya funcionaron y consume el cupo dos veces. La Skill limita el reintento a las rutas fallidas.

También existe una salida para diferencias entre versiones. Si la CLI instalada no coincide con la Skill, el agente ejecuta pipic --help y sigue el programa realmente instalado. La Skill puede actualizarse de forma independiente; el ejecutable sigue siendo la autoridad durante la ejecución.

La CLI hace el trabajo con las imágenes

La Skill no contiene un codificador, no sube bytes de imágenes y no comprime nada por sí misma. Enseña al agente a invocar la CLI. La CLI resuelve las rutas, comprueba el destino, llama al servicio alojado, escribe de forma atómica los resultados más pequeños y emite las filas que el agente interpreta.

Una ejecución publicada en nuestro benchmark del tercer trimestre de 2026 procesó landscape.png con PiPic Agent CLI 1.0.6. El archivo registrado tenía 2.316.198 bytes antes y 723.577 después, un ahorro de 1.592.621 bytes. Es una imagen de prueba con licencia pública y una ejecución registrada, no una promesa para todos los PNG. El benchmark publica las entradas, los comandos exactos, las 72 filas sin procesar y sus limitaciones.

En una tarea normal de un agente, lo útil es el contrato alrededor de ese número. El agente puede explicar qué archivo cambió, cuántos bytes se ahorraron, cuáles quedaron intactos y si alguna ruta necesita atención. No tiene que interpretar una animación de progreso ni una frase escrita para una persona.

El MCP remoto está separado de esta ruta de ejecución. Es una guía de integración de solo lectura que ayuda a descubrir la CLI y la API HTTP. Los bytes de las imágenes viajan por la CLI o por una petición HTTP directa, no por JSON-RPC.

Mantén explícito el límite humano

El agente nunca instala por su cuenta un paquete global ni ejecuta pipic login. Una instalación global cambia el entorno del usuario. El inicio de sesión abre un navegador o espera la aprobación de un código de dispositivo que solo el usuario puede completar. Si pipic whoami termina con el código 3, la acción correcta es detenerse y pedir esa aprobación.

Las credenciales guardadas por pipic login sirven para futuras ejecuciones del agente en la misma máquina. Un contenedor, una tarea de CI o un sandbox pueden no ver el ~/.config del usuario; esos entornos utilizan un PIPIC_TOKEN creado por el usuario en la página de cuenta.

La CLI y la API de PiPic tienen un cupo mensual separado: 100 imágenes en Free y 5.000 en Pro. El compresor web sigue siendo gratuito, ilimitado y sin cuenta. Las imágenes de la CLI salen de la máquina para procesarse y se eliminan del servidor en cuanto termina la compresión; la página de privacidad explica el manejo completo.

La división queda clara. La persona instala y autoriza la herramienta. La Skill aporta las reglas de operación, el agente decide cuándo invocarla y la CLI realiza el trabajo con un contrato de salida que el agente puede seguir de verdad.