local-time

name	local-time
description	Obtiene la hora exacta del sistema local mediante scripts multiplataforma. Trigger: Cuando el usuario pregunta por la hora, fecha, timestamp, o necesita sincronizar acciones con el tiempo actual del sistema.
license	MIT
metadata	{"author":"mapplics","version":"1.0"}
allowed-tools	Bash, PowerShell

Local Time

"El tiempo es la medida del cambio." — Aristóteles

Cuándo Usar

Activa este skill cuando:

• El usuario pregunta "¿qué hora es?" o similar
• Necesitas sincronizar acciones con la hora actual
• Debes registrar timestamps en logs o archivos
• El usuario pide información de zona horaria

No usar cuando:

• La hora ya fue proporcionada en el mensaje del sistema (ver metadata)

---

Scripts Disponibles

Este skill proporciona scripts multiplataforma para obtener la hora del sistema.

Linux/macOS (Bash)

# Ejecutar script
./skills/local-time/scripts/get_time.sh [formato]

Windows (PowerShell)

# Ejecutar script
.\skills\local-time\scripts\get_time.ps1 [formato]

---

Formatos Disponibles

Formato	Ejemplo	Uso
iso	2026-02-06T15:40:50-03:00	Logs, APIs, timestamps completos
time	15:40:50	Hora simple
date	2026-02-06	Fecha ISO
datetime	2026-02-06 15:40:50	Fecha y hora legible
unix	1770424850	Epoch timestamp
full	Todas las anteriores	Información completa

---

Árbol de Decisiones

¿Usuario pregunta por hora/fecha/timestamp?
├── SÍ → ¿Qué formato necesita?
│   ├── No especificado → Usar formato `iso`
│   ├── Solo hora → Usar formato `time`
│   ├── Solo fecha → Usar formato `date`
│   ├── Timestamp numérico → Usar formato `unix`
│   └── Todo → Usar formato `full`
└── NO → No usar este skill

---

Ejemplos de Uso

Obtener hora ISO (por defecto)

# Linux/macOS
./skills/local-time/scripts/get_time.sh iso

# Windows PowerShell
.\skills\local-time\scripts\get_time.ps1 iso

Salida: 2026-02-06T15:40:50-03:00

Obtener solo la hora

./skills/local-time/scripts/get_time.sh time

Salida: 15:40:50

Obtener timestamp Unix

./skills/local-time/scripts/get_time.sh unix

Salida: 1770424850

Obtener información completa

./skills/local-time/scripts/get_time.sh full

Salida:

ISO:      2026-02-06T15:40:50-03:00
Date:     2026-02-06
Time:     15:40:50
DateTime: 2026-02-06 15:40:50
Unix:     1770424850
Timezone: America/Argentina/Buenos_Aires
UTC Offset: -03:00

---

Tabla de Referencia Rápida

Pregunta del Usuario	Formato	Comando
"¿Qué hora es?"	time	get_time.sh time
"¿Cuál es la fecha?"	date	get_time.sh date
"Dame el timestamp"	unix	get_time.sh unix
"¿Qué hora es en formato ISO?"	iso	get_time.sh iso
"Dame toda la info de tiempo"	full	get_time.sh full

---

Comportamiento del Agente

Cuando trabajes con este skill:

1. Detectar: Identifica si el usuario pregunta por hora/fecha/timestamp
2. Elegir formato: Selecciona el formato más apropiado según el contexto
3. Ejecutar: Usa el script correspondiente a la plataforma
4. Reportar: Comunica el resultado de forma clara

Notas Importantes

• Prefiere el formato iso para logs y registros
• El script detecta la zona horaria automáticamente
• En Windows, asegúrate de que PowerShell permita ejecución de scripts