agentleFS
jeronimo114jeronimo114/claude-skills/skills/pecositas-informe-horario/SKILL.md

pecositas-informe-horario

Skill0 starsChanged 58 days agoMITView on GitHub

Genera el informe interactivo de ventas por franja horaria de Pecositas (empanadas y fritos, sedes Envigado e Interplaza) y la presentación para gerencia, a partir de las exportaciones del ERP Alfa (un xlsx por sede y mes). Úsalo siempre que lleguen archivos nuevos de ventas de Pecositas, pidan "el informe por hora", "el dashboard de franjas", "cuántos domiciliarios por franja", "qué producto se vende a qué hora", o haya que rehacer o actualizar el deck para gerencia. Incluye las reglas del ERP (devoluciones, impuestos, hojas duplicadas), la marca, la paleta validada, el copy aprobado del deck y copias completas de las skills de tono de redacción y de visualización que se usaron.

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈0

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    No se arregla a ciegas. Se generan seis a ocho alternativas completamente distintas con contexto/immpulso-slides/plantilla/_variantes.py, …

    line 88

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Informe de ventas por hora de Pecositas

Dos entregables, los dos HTML autocontenidos y en la marca de Pecositas (fondo negro, rojo #a50004, Bebas Neue):

  1. Informe interactivo (dashboard): millones y unidades por hora, por canal, por día de la semana, por producto, y domiciliarios necesarios por franja. Con filtros de vista, mes, tipo de día y promedio/total.
  2. Deck para gerencia: 23 slides con lo relevante de domicilios y productos y las sugerencias de proceso. Redactado en el tono de Jero.

Antes de empezar, lee en este orden:

  • references/encargo-y-estructura.md — qué pidió el cliente y qué hay en cada entregable.
  • references/reglas-de-datos.md — lo que no es obvio en los archivos del ERP. Obligatorio.
  • references/marca-y-diseno.md — colores, fuente, paleta validada, tamaños de letra.
  • contexto/tono-presentaciones/SKILL.md — el tono del copy, con sus referencias. Obligatorio antes de tocar una slide.

Cómo se genera

SK=~/.claude/skills/pecositas-informe-horario      # o la carpeta donde quedó la skill
cd <carpeta con los xlsx>

# 1. Consolidar los archivos → datos.json  (2–3 minutos; ignora copias idénticas)
python3 $SK/scripts/build_datos.py . datos.json

# 2. Informe interactivo
python3 $SK/scripts/armar_informe.py datos.json "Informe Pecositas - Ventas por franja horaria.html"

# 3. Cifras del deck, para revisar el copy contra los datos nuevos
python3 $SK/scripts/cifras_deck.py datos.json

# 4. Deck (después de corregir a mano las cifras del copy en armar_deck.py)
python3 $SK/scripts/armar_deck.py datos.json "Presentacion Pecositas - Ventas por hora - Gerencia.html"

# 5. Verificar el tono
python3 $SK/contexto/tono-presentaciones/revisar.py $SK/scripts/armar_deck.py

Si el cliente pide otro periodo, basta con poner los xlsx de esos meses en la carpeta: los meses, el periodo y las fuentes salen de los datos.

Reglas que ya costaron una corrección

  • Ventas = Precio Neto (sin impoconsumo ni IVA). El cliente lo pidió así. La columna Precio Neto+IVA viene incompleta en julio; no usarla nunca.
  • Devoluciones restadas en valor y en cantidad (el ERP exporta la cantidad en positivo).
  • Solo la hoja Sheet, sin la fila final de total, sin archivos ni hojas repetidos.
  • Letra grande. El cliente ve borroso con letra pequeña. Los tamaños actuales son el mínimo.
  • El copy del deck no narra. Una idea por slide, sin "no es X, es Y", sin títulos con dos puntos, sin cifras apiladas. revisar.py debe dar 0 avisos y luego hay que leerlo.
  • Ninguna cifra en el deck sin poderse señalar en la salida de cifras_deck.py.
  • Antes de entregar, mirarlo: references/verificacion.md (barrido de estructura, capturas con Chrome sin cabeza, hoja de contacto).

Qué hay en la carpeta

RutaQué es
scripts/build_datos.pyConsolida los xlsx y calcula el cubo datos.json.
scripts/armar_informe.pyIncrusta datos, fuente y Chart.js en la plantilla del informe.
scripts/armar_deck.pyEl deck: la lista S con el copy aprobado y el generador (lienzo 1600×900, SVG propios).
scripts/cifras_deck.pyImprime cada cifra que usa el copy, slide por slide.
assets/informe_template.htmlLa plantilla del informe (HTML, CSS y JS de filtros y gráficas).
assets/bebas.woff2, assets/chart.umd.jsFuente de marca y Chart.js 4.4, para incrustar.
references/Encargo, reglas de datos, marca y diseño, verificación.
contexto/tono-presentaciones/La skill de tono de Jero, completa (reglas, rechazos, reescrituras, revisar.py).
contexto/dataviz/La skill de visualización que se siguió (forma, color, validador de paleta, anti-patrones).
contexto/immpulso-slides/Solo lo que el tono referencia: SKILL.md, referencia/copy.md y plantilla/_variantes.py (para resolver una slide rechazada con variantes).
ejemplos/Las dos salidas aprobadas del 17 de septiembre de 2026 y su datos.json, como referencia de cómo debe verse el resultado.

Cuando el cliente rechaza una slide

No se arregla a ciegas. Se generan seis a ocho alternativas completamente distintas con contexto/immpulso-slides/plantilla/_variantes.py, él puntúa y la ganadora vuelve a S. Si da una dirección general ("más breve", "más suave"), se aplica a todo el deck y se vuelve a leer completo: acortar rompe referentes.

Contexto del cliente

Pecositas vende empanadas, palos de queso, croquetas, rollos y pasteles en dos sedes (Envigado, con domicilios propios; Interplaza, sin domicilios) y por Rappi. Tiene 6 domiciliarios propios y un servicio externo (Amazonas). Quiere saber a qué hora se vende qué, para producir por franja y para no tener domiciliarios quietos. El ERP es Alfa. La web es pecositas.com.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.