# Publicar

> Use when Felipe escribe «/publicar <video>», «publica este video», «programa este reel» o entrega un video vertical ya listo para subirlo a @ia.punto.es (revisa el video, pregunta cuándo, escribe el caption, muestra todo, espera el OK y lo programa).

- Skill: `fnvasque/publicar` (Agent Skill)
- Install (CLI): `npx get-skill add fnvasque/publicar`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fnvasque/publicar/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: fnvasque (https://skillmd.com/u/fnvasque)
- Updated: 2026-11-19
- Page: https://skillmd.com/skills/fnvasque/publicar

---


# /publicar — publicar un video ya listo en @ia.punto.es

Toma un video terminado (en cualquier proyecto), lo revisa, escribe el caption, te lo muestra y,
**solo con tu OK explícito**, lo programa como una pieza extra del calendario. Nunca reemplaza una
pieza del planificador.

## Cómo se llama el comando (siempre así)

```
npm --prefix ~/Documents/Claude/Carrusel-render run -s publicar -- <sub> "<video>" …
```

**Siempre en `Carrusel-render`, nunca en `Carrusel`.** Por qué: el render horario del Mac busca la
carpeta final con su manifiesto en el `output/` de `Carrusel-render`; si el comando corre desde otro
lugar, el render no la encuentra, intenta re-renderizar la pieza y la marca fallida. Eso también
significa que `publicar` solo existe ahí después de que la rama se mergee a `main`.

Subcomandos (todos imprimen JSON en stdout; los errores salen por stderr con `✗ …` y código 1):

| Subcomando | Qué hace |
|---|---|
| `revisar "<video>" [--transcribir]` | Inspecciona el video y saca cuadros. No escribe en la base. |
| `programar "<video>" --cuando "<ahora\|AAAA-MM-DD HH:MM>" --hook "<texto>" --caption-file "<ruta absoluta>" [--id <id>] [--dry-run]` | Con `--dry-run` valida y no escribe nada; sin él, deja la pieza programada. |

## Flujo (en este orden)

1. **Ruta del video.** Pídela si Felipe no la dio. Siempre absoluta (si es relativa, resuélvela con
   el directorio del proyecto donde está trabajando).

2. **Revisar.** Corre `revisar "<video>" --transcribir`. Devuelve:
   `info` (`ancho`, `alto`, `duracionMs`, `codec`, `tieneAudio`), `errores`, `avisos`,
   `cuadros` (`cover`, `story`, `clave[]`: rutas de imágenes), `transcripcion` (solo con
   `--transcribir`), `hashtagsBase` y `semanasConPlan`.
   - Si `errores` trae algo (no vertical, < 3 s, > 900 s, códec que no sirve): muéstralos y **para**.
   - Si `avisos` trae algo: muéstralos y pregunta si sigue. Si el aviso dice que el aspecto no es
     9:16, dile claro que **la portada y la story recortan los bordes**.
   - Si `revisar --transcribir` falla (sale con `✗` y sin JSON), vuelve a correr `revisar` sin
     `--transcribir` y avisa que no hay transcripción. Lo mismo si el video no tiene audio.

3. **Cuándo.** Pregunta «¿cuándo lo quieres publicar?» y traduce la respuesta:
   - «ahora» → `--cuando ahora` (el próximo :00 o :30 con al menos 15 min de margen).
   - Día y hora → `--cuando "AAAA-MM-DD HH:MM"` (hora de Chile). Resuelve «mañana», «el viernes»
     con la fecha de hoy.
   - Si la hora no es `:00` ni `:30`, proponle la más cercana y espera su respuesta.
   - Solo valen semanas que ya tienen plan (`semanasConPlan` de `revisar`). Si el error dice que la
     semana aún no tiene plan, explícaselo y pídele otra fecha.

4. **Caption y hook.** Mira con Read los `cuadros.clave` (y lee la transcripción si hay). Escribe:
   - **hook**: una frase corta que diga lo que el video entrega (va en `--hook`).
   - **caption**, para quien está aprendiendo: una idea, una acción, un ejemplo simple, sin
     jerga sin explicar. Firma como **@ia.punto.es** con «Te ayudo a partir…»; **nunca con el
     nombre de Felipe**. Termina con los `hashtagsBase` que devolvió `revisar`.
   - Límites: máximo **2200 caracteres** y **30 hashtags**.
   - Guarda el caption en un archivo del scratchpad (con Write, no con heredoc) y pásalo a
     `--caption-file`, siempre con **ruta absoluta**: el comando resuelve las rutas relativas contra
     `Carrusel-render`, no contra tu proyecto.

5. **Simulacro.** Corre `programar … --dry-run` (no escribe nada). Devuelve `semana`, `id`, `dia`,
   `hora`, `cercanas` (ids de piezas a menos de 2 h), `avisos`, `carpeta`, `programada: false`.
   Úsalo para validar día, hora, id y cercanías **antes** del OK. Luego **muestra todo**:
   - el caption completo y el hook;
   - la portada (`cuadros.cover`) y la story (`cuadros.story`) de `revisar`, con Read;
   - día y hora resueltos, y el `id`;
   - las `cercanas` (si hay, avisa que quedaría a menos de 2 h de esas piezas) y los `avisos`.

6. **Esperar el OK.** Solo un OK explícito en el chat («publícalo», «ok, programa», «dale
   adelante») sirve. Si pide cambios (caption, hora, hook), aplícalos, repite el paso 5 y vuelve a
   mostrar. Cualquier cambio exige un nuevo `--dry-run` y un nuevo OK.

7. **Programar.** Con el OK, corre el mismo comando **sin `--dry-run`** y con **`timeout: 600000`**
   en la herramienta Bash (sube el plan a la base y dispara el render en línea, que puede pasar
   los 2 min por defecto; si Bash lo corta entre el plan y el push, queda a medias). Devuelve lo
   mismo más `programada`, `render` (`ok`, `salida`) y `subida`. Reporta según `subida`, **nunca
   muestres URLs** (llevan token):
   - `subida: true` → quedó programada y la subida está confirmada y verificada por el render
     (`render.json` en `renderizado`).
   - `subida: false` → quedó programada, pero el render aún no la subió: el render horario la
     subirá antes de la hora; conviene revisar más tarde.
   - `render.ok` en `false` → muestra la `salida` tal cual (sin URLs); la pieza sigue programada y
     el render horario reintenta.
   - Error que dice «No quedó nada programado» → díselo tal cual y que puede reintentar.
   - Error que dice «No pude deshacer» → muéstrale los comandos de limpieza que trae el error,
     tal cual; no los corras tú.
   - `programada: true` con algo en `avisos` (por ejemplo «el commit llegó a la base pero la
     verificación falló») → muéstralo tal cual.
   - Error «publicar solo corre desde …» → corriste el comando fuera de `Carrusel-render`; usa la
     forma de arriba.
   - Error «queda a menos de 15 min» → pídele otra hora o usa «ahora».
   - Error «el hook necesita letras o números» → pasa `--id` con un id propio (minúsculas, números
     y guiones) y repite el `--dry-run`.
   - Error «id repetido» → **antes de reintentar**, revisa si esa pieza ya quedó programada (no se
     debe programar dos veces): mira `plan.json` de la semana en el clon de la base o pregúntale a
     Felipe. Si no existe, usa `--id` con otro id.
   - Cualquier otro error: muéstralo tal cual y no reintentes sin avisarle.

## Prohibido

- Correr `programar` sin `--dry-run` antes del OK explícito de Felipe (y solo después de haberle
  mostrado el caption, la portada, la story, el día y la hora).
- Reemplazar o mover piezas del planificador.
- Editar `render.json` o `estado.json`, o tocar a mano `plan.json` y la carpeta de salida.
- Correr el comando desde `Carrusel` o desde el proyecto del video.
- Poner el nombre de Felipe en el caption o el hook.

