Communitygithub.com

av/remotion-bits

Publica remotion-bits en GitHub, Cloudflare y npm. Úsalo al aumentar la versión del paquete, actualizar CHANGELOG.md, construir el registro, crear el commit de release, hacer push a master, abrir un formulario de release de GitHub prellenado, desplegar la documentación y publicar en npm.

¿Qué es remotion-bits?

Este skill automatiza el flujo completo de release para el paquete remotion-bits. Está diseñado para ahorrar tiempo y eliminar errores manuales al realizar tareas repetitivas como aumentar la versión, actualizar el changelog, construir el registro de paquetes, hacer commit y push, preparar una release de GitHub, desplegar documentación en Cloudflare y publicar en npm. Es compatible con cualquier asistente de IA o agente que pueda ejecutar comandos de terminal y acceder a Git, npm y la línea de comandos del sistema operativo. El skill guía al agente paso a paso: primero determina la versión objetivo (por defecto patch), luego redacta notas de release a partir del historial de Git, actualiza el changelog, aumenta la versión en package.json, ejecuta el script de construcción del registro, realiza el commit y push, abre un formulario de GitHub prellenado para la release, espera confirmación del usuario si es necesario, despliega la documentación y finalmente publica en npm. Incluye reglas de decisión claras para manejar casos como credenciales faltantes, cambios no relacionados en el working tree o fallos en la construcción.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/av/remotion-bits/tree/HEAD/.github/skills/release

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Remotion Bits Release

Usa este skill cuando prepares y publiques una nueva release de remotion-bits desde este repositorio.

Qué Hace Este Skill

Este skill realiza el flujo de trabajo completo de release:

  1. Aumenta la versión en ./package.json. Por defecto, un aumento de tipo patch a menos que el usuario solicite explícitamente minor, major o una versión específica.
  2. Actualiza CHANGELOG.md con notas de release concisas para la nueva versión.
  3. Ejecuta npm run registry:build.
  4. Realiza el commit de los cambios de release con chore: vX.Y.Z.
  5. Hace push del commit de release a master.
  6. Investiga los cambios notables desde la release anterior en el historial de Git y los PRs fusionados.
  7. Abre el formulario de release de GitHub prellenado con el navegador del sistema, no el navegador interno.
  8. Después de que la release de GitHub se publique, despliega la documentación con ./scripts/deploy-docs.sh.
  9. Publica el paquete en npm con npm publish.

Precondiciones

  • Trabaja desde la raíz del repositorio.
  • No inicies el servidor de desarrollo de documentación.
  • Asume que la publicación de la release requiere credenciales válidas de GitHub, Cloudflare y npm ya configuradas en el entorno.
  • Si el working tree contiene cambios no relacionados del usuario, no los reviertas. O trabaja alrededor de ellos o detente y pregunta antes de tocarlos si afectan los archivos de release.

Flujo de Release

1. Determinar la Versión Objetivo

  • Lee la versión actual desde ./package.json.
  • Si el usuario dio una versión específica, úsala.
  • Si el usuario dio un tipo de aumento, aplícalo.
  • De lo contrario, aumenta patch.
  • La etiqueta git y el título de la release deben ser vX.Y.Z.

2. Preparar las Notas de Release

  • Revisa los commits desde la última etiqueta de release.
  • Revisa los PRs fusionados cuando ayuden a resumir los cambios.
  • Actualiza CHANGELOG.md insertando la sección de la nueva versión al principio.
  • Mantén las entradas concisas y orientadas al usuario.
  • Usa este formato:
### vX.Y.Z

- Característica: Breve descripción de la nueva funcionalidad
- Corrección: Breve descripción de la corrección de errores
- Mejora: Breve descripción de la mejora
- Documentación: Breve descripción del cambio en la documentación

3. Aumentar la Versión y Construir el Registro

  • Actualiza ./package.json a la nueva versión.
  • Ejecuta:
npm run registry:build
  • Si la construcción falla, detente y corrige el problema subyacente antes de continuar.

4. Commit y Push de la Release

  • Revisa el diff de la release.
  • Realiza el commit de la release preparada con:
git commit -am "chore: vX.Y.Z"
  • Haz push del commit a master.
  • Si el repositorio está por detrás del remoto o el push falla, resuelve ese estado antes de continuar.

5. Crear el Borrador de la Release de GitHub

  • Construye las notas de release a partir del resumen del changelog y los commits recientes.
  • Abre esta URL con xdg-open u otro comando de apertura a nivel de sistema, nunca el navegador interno:
https://github.com/everlier/remotion-bits/releases/new?tag=vX.Y.Z&target=master&title=vX.Y.Z&body=...
  • Prellena el formulario con:

    • tag: vX.Y.Z
    • target: master
    • title: vX.Y.Z
    • prerelease: false
  • El cuerpo de la release debe seguir esta estructura:

## Novedades

- Una frase corta por cada nueva funcionalidad notable.
- Una frase corta por cada corrección de errores notable.
- Una frase corta por cada mejora notable.

**Changelog Completo**: https://github.com/everlier/remotion-bits/compare/vX.Y.(Z-1)...vX.Y.Z
  • Pausa para que el usuario publique la release de GitHub si se requiere confirmación en el navegador.

6. Desplegar la Documentación

  • Después de que la release de GitHub se publique, ejecuta:
./scripts/deploy-docs.sh

7. Publicar en npm

  • Confirma que la autenticación de npm esté disponible.
  • Publica desde la raíz del repositorio:
npm publish

Reglas de Decisión

  • Por defecto, las releases son de tipo patch a menos que el usuario indique lo contrario.
  • Si las notas de release no están claras, derívalas del historial de commits antes de preguntar al usuario.
  • Si un comando modifica artefactos de release, mantén esos cambios generados en el commit de release.
  • Si la publicación requiere un paso manual en el navegador, detente en el límite, dile exactamente al usuario qué está esperando y luego continúa después de la confirmación.
  • Si faltan credenciales para GitHub, Cloudflare o npm, detente e informa del requisito faltante en lugar de reintentar ciegamente.

Lista de Verificación de Finalización

  • package.json tiene la versión objetivo.
  • CHANGELOG.md tiene una nueva sección superior para esa versión.
  • npm run registry:build se completó correctamente.
  • El commit de release chore: vX.Y.Z existe y se ha hecho push a master.
  • El formulario de release de GitHub se abrió con los valores prellenados correctos.
  • El despliegue de documentación se completó.
  • npm publish se completó correctamente.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados