treeturtlefall-arch/skill

film-date-agent

Procedimiento para que un agente de IA pueda usar una herramienta que imprime la exposición óptica física de un sello de fecha de cuarzo de cámara analógica en imágenes. El renderizado lo realiza un motor de simulación óptica física (FilmDateStamp), y esta skill especifica que ante una solicitud, se debe aplicar sin dudar el preset y la fecha/hora óptimos, e informar correctamente el resultado.

Herramientas

• Comando: film-date-agent (o python -m film_date_agent)
• Verificación de instalación: film-date-agent doctor debe mostrar todos los elementos como [OK]
• Preset: favorite (favorito) es el predeterminado. La entidad real la define favorites.json (por defecto: Japanese Snap (Disposable): estilo cámara desechable, brillo naranja, puntos de cápsula 5x7, hora y minutos incluidos).

Si no está instalado o no se encuentra el comando

• Si film-date-agent no existe o doctor falla, primero instálelo. Si el repositorio (https://github.com/treeturtlefall-arch/FilmDateStamp-agent) ya está clonado, ejecute bash scripts/install_agent.sh y luego bash scripts/install_skill.sh para recolocar esta skill.
• Después de la instalación, ejecute nuevamente film-date-agent doctor --json y verifique que "ok": true antes de continuar con este procedimiento.

Palabras de activación (cuando se den estas instrucciones, actuar)

• «Pon un sello de fecha en la foto», «Añade una fecha con estilo analógico», «Pon una fecha retro»
• «Hazlo estilo cámara desechable», «Pon una fecha de los 90», «Hazlo estilo réflex de los 80»
• «Imprime la fecha de captura», «Pon la fecha del EXIF»
• «Incluye también la fecha y la hora»
• También aplica si justo después de generar o editar una imagen se dice «Pon el sello de fecha»

Procedimiento de ejecución

1. Identificar la imagen objetivo:

   • Identifique la imagen mencionada en la conversación o la que se acaba de generar/editar. Si no está claro, no adivine; pregunte.

2. Seleccionar preset y parámetros:

   • Sin especificación: Use el favorito predeterminado (favorite).

     film-date-agent apply <imagen_objetivo> --json
     

   • Con especificación de ambiente, época o estilo:
     • «Estilo cámara desechable», «Estilo cámara de un solo uso»: --preset japanese-snap-disposable (brillo naranja, puntos de cápsula 5x7, hora y minutos incluidos)
     • «Japón 90s», «Snap de Tokio»: --preset japanese-tokyo-90s (brillo ámbar, segmentos 7 estilo 80s)
     • «Estilo americano», «Costa Oeste»: --preset american-west-coast (amarillo dorado, orden mes-día-año)
     • «Motel de los 80», «LED rojo»: --preset american-80s-red-quartz (cuarzo rojo, segmentos 7 verticales de réflex)
     • «Europa», «París/Berlín»: --preset european-classic-parisberlin (separación por puntos, exposición moderada)
     • «Principios de los 2000», «Cámaras digitales compactas tempranas»: --preset y2k-digicam-early-2000s (fuente LCD de ancho fijo)
     • «Años 70», «Cámara clásica»: --preset monochrome-70s-canodate-e o --preset vintage-70s-color-datematic (tipo mecánico grabado)
     • «Cyber», «Ciencia ficción»: --preset cyber-telemetry-80s-sci-fi (HUD verde cibernético)
     • «Retro Heisei», «Estilo purikura»: --preset y2k-pop-heisei-fancy (letras redondeadas rosa neón)

3. Montar opciones de fecha y hora:

   • Sin especificación (predeterminado): En el preset favorito, sigue la configuración date de favorites.json (valor inicial photo), que determina automáticamente: fecha de captura EXIF → fecha de creación/modificación del archivo → hora actual. En otros presets, se usa la fecha predeterminada de cada preset.
   • Si se desea la fecha de captura de la foto:
     • «Con la fecha de captura», «Con la fecha del EXIF» → Añadir --date photo (extrae automáticamente la fecha de captura del EXIF).
   • Si se especifica una fecha concreta:
     • «Pon 24 de diciembre de 1998» → -d "'98 12 24" o --at 1998-12-24
     • «15 de agosto de 2004 a las 14:30» → --at 2004-08-15T14:30 --show-time
   • Si se desea la fecha/hora actual:
     • «Con la fecha de hoy», «Con la hora actual» → --date auto
   • Mostrar/ocultar hora (HH:MM):
     • «Incluye también la hora», «Con hora y minutos» → --show-time
     • «Solo la fecha», «Sin hora» → --no-time
   • Si se desea una fecha vintage aleatoria:
     • «Una fecha antigua al azar», «Aleatoria» → --date random

4. Reportar el resultado:

   • Analice la salida --json y, si ok es true, presente y reporte al usuario la ruta de la imagen almacenada en output.
   • Añada un comentario con la cadena de fecha real estampada (date_text) y el estilo aplicado (preset_resolved).
   • Ejemplo: «Se ha estampado la fecha de captura '03 10 02 17:49 con estilo Tokyo 90s (Japanese Tokyo 90s).»

5. Manejo de errores:

   • Código de salida 2 (error de configuración): Ejecute film-date-agent presets list para ver los presets disponibles y elegir otro.
   • Código de salida 3 (archivo de entrada no encontrado): Verifique la ruta de la imagen de entrada.
   • Código de salida 4 (archivo de salida duplicado): Por defecto se añade un número secuencial (_stamped_1), pero si se solicita sobrescritura, añada --overwrite.
   • Código de salida 5 (fallo del motor): Ejecute film-date-agent doctor y reporte el resultado al usuario.

Si preguntan «¿Qué puedes hacer?»

1. Ejecute film-date-agent capabilities --json y responda basándose en la lista de capacidades más reciente.
2. Plantilla de explicación:
   • Es una herramienta que simula la impresión óptica sobre emulsión de película (exposición óptica física, quemado del centro, difusión por halación).
   • Dispone de 12 presets por época y región (Tokyo 90s, cámara desechable, Costa Oeste, LED rojo 80s, cámaras compactas tempranas, etc.).
   • La fecha puede elegirse entre la fecha de captura EXIF de la foto, la fecha/hora actual, una fecha vintage aleatoria, o una cadena personalizada.
   • Permite crear configuraciones personalizadas y guardarlas como «favorito (favorite)».

Reglas a seguir

• No sobrescribir directamente la imagen original (no especificar la misma ruta que la entrada en -o).
• El reporte debe basarse estrictamente en el campo output del JSON. No adivinar nombres de archivo.