Saltar a contenido

Plan: Integrar Skills de Apicultura en la Web de SmallCountry

Para OpenCode: Lee este plan completo primero. Luego implementa tarea por tarea. Modo PLAN — no ejecutar nada sin que Tonatiuh lo valide.

Objetivo: Integrar las 4 skills de apicultura de Hermes Agent como documentación y herramientas web en el sitio MkDocs de SmallCountry.

Skills a integrar:

Skill Hermes Existe como doc web Propósito
apicultura (umbrella) ❌ No Documentación general del sistema de skills
field-audio-processing ❌ No Cómo se procesan los audios → JSONL + diario
preparacion-visita-colmenar ❌ No Briefing pre-visita con estado y materiales
finalizar-visita-colmenar ❌ No Cierre de jornada: dashboard, CSV histórico, empaquetado

📁 Estructura de archivos

web/docs/apicultura/
├── index.md                           ← página principal (ya existe: apicultura/)
├── tipos-colmena/                     ← ya existe
├── skill-apicultura.md                ← nueva: umbrella skill
├── procesar-audios.md                 ← nueva: field-audio-processing
├── preparar-visita.md                 ← nueva: preparacion-visita-colmenar
└── finalizar-visita.md                ← nueva: finalizar-visita-colmenar

🎯 Tareas

Tarea 1: Crear skill-apicultura.md

Ubicación: web/docs/apicultura/skill-apicultura.md

Contenido: resumen de las 4 skills, cómo se relacionan, disparadores en castellano. Incluir tabla:

| Si dices... | Skill que se activa | Qué hace |
|---|---|---|
| «Mañana voy a Cinco Fuentes» / «Prepara la visita» | `preparacion-visita-colmenar` | Briefing pre-visita |
| «Te mando los partes» / «Estoy en el colmenar» | `field-audio-processing` | Transcripción de audios |
| «He terminado» / «Cierra el parte» | `finalizar-visita-colmenar` | Dashboard + archivos |

Frontmatter estándar (misma capa que corral-del-viento.md): 

---
status: Operativo
layer: operativa
---

Tarea 2: Crear procesar-audios.md

Ubicación: web/docs/apicultura/procesar-audios.md

Contenido adaptado de field-audio-processing skill: - Cómo se procesan los audios de Ninón (Whisper → JSONL → diario) - Modo silencio vs modo ficha rápida - Estructura de datos: visitas-YYYY-MM.jsonl, diario-smallcountry.md - 4 colmenares: Cinco Fuentes, El Salto, Casa Margarita, Hoyaroas - Incluir referencias al protocolo de visitas

Tarea 3: Crear preparar-visita.md

Ubicación: web/docs/apicultura/preparar-visita.md

Contenido adaptado de preparacion-visita-colmenar: - Briefing pre-visita - Lista de materiales para la furgoneta según tareas pendientes - Alertas: colmenas urgentes, huérfanas, con miel lista - Ejemplo de briefing completo

Tarea 4: Crear finalizar-visita.md

Ubicación: web/docs/apicultura/finalizar-visita.md

Contenido adaptado de finalizar-visita-colmenar: - Dashboard HTML desde JSONL - CSV histórico (wide format: columnas = fechas, filas = colmenas) - Empaquetado opcional en ZIP - Qué archivos se generan al cerrar la jornada

Tarea 5: Actualizar mkdocs.yml

Ubicación: web/mkdocs.yml

Añadir las 4 nuevas páginas bajo Apicultura en el nav:

  - Apicultura:
    - apicultura/index.md
    - Tipos de colmena: apicultura/tipos-colmena/index.md
    - Skills del sistema: apicultura/skill-apicultura.md
    - Procesar audios: apicultura/procesar-audios.md
    - Preparar visita: apicultura/preparar-visita.md
    - Finalizar visita: apicultura/finalizar-visita.md

Tarea 6: Vinculación con proyecto Corral del Viento

En corral-del-viento.md (sección 8.3 donde dice:

Hermes Agent incorporará una skill apicultura

Actualizar ese párrafo para que enlace a las nuevas páginas de skills en lugar de ser una nota de futuro.

📋 Referencias para el implementador

Las skills originales están en ~/.hermes/skills/: - productividad/apicultura/SKILL.md — umbrella - note-taking/field-audio-processing/SKILL.md — procesar audios - productivity/preparacion-visita-colmenar/SKILL.md
- productividad/finalizar-visita-colmenar/SKILL.md

El archivo corral-del-viento.md se usa como referencia para la vinculación.

🐛 Pitfalls

  1. No copiar las skills literalmente — adaptar a tono web (explicativo, no técnico-instruccional)
  2. Respetar frontmatter de MkDocs (status, layer)
  3. No romper enlaces existentes — verificar que mkdocs.yml sigue funcionando
  4. Los nombres de colmenares son: Cinco Fuentes, El Salto, Casa Margarita, Hoyaroas. Hoyaroas NO es «Rozas».
  5. No eliminar nada existente — solo añadir páginas nuevas y actualizar nav
  6. Usar español — toda la web está en español
📋 Relacionado con
🔧 Operaciones