Habilidades github-release-assistant

📦

github-release-assistant

Name: github-release-assistant
Author: ZhanlinCui

Seguro

Generar documentación de versiones de GitHub bilingüe

Crear documentación de versiones pulida requiere tiempo y consistencia entre idiomas. Esta habilidad automatiza la generación de README bilingüe a partir de los metadatos existentes de tu repositorio.

Soporta: Claude Codex Code(CC)

🥇 84 Oro

Descargar el ZIP de la skill

Subir en Claude

Ve a Configuración → Capacidades → Skills → Subir skill

Activa y empieza a usar

Pruébalo

Usando "github-release-assistant". Repositorio con config.json conteniendo metadatos del proyecto y un archivo requirements.txt

Resultado esperado:

Dos archivos creados: README.md (inglés) y README.zh.md (chino) con estructura coincidente incluyendo descripción general del proyecto, capacidades clave, instrucciones de inicio rápido e insignias de licencia

Usando "github-release-assistant". Ejecutar generador con flags --language both --overwrite en documentación existente

Resultado esperado:

Los archivos README actualizados reemplazan versiones anteriores mientras se preserva el historial de git a través de cambios preparados listos para revisión

Auditoría de seguridad

Seguro

v1 • 2/24/2026

Static analysis flagged 53 patterns but all are false positives. The 'weak cryptographic algorithm' warnings match MATLAB function names (BDF1, BDF2, ode45) in documentation, not actual crypto code. 'Ruby backtick execution' is Python code with markdown documentation formatting. Hardcoded URLs are standard badge images from shields.io. Unicode regex detects CJK characters for bilingual support. No malicious intent, no credential handling, no external API calls beyond static badge URLs.

Archivos escaneados

676

Líneas analizadas

hallazgos

Auditorías totales

No se encontraron problemas de seguridad

Auditado por: claude

Puntuación de calidad

Arquitectura

100

Mantenibilidad

Contenido

Comunidad

100

Seguridad

Cumplimiento de la especificación

Lo que puedes crear

Mantenedor de Proyecto de Código Abierto

Generar documentación de versiones bilingüe consistente para cada versión de GitHub sin escribir manualmente ambas versiones en diferentes idiomas.

Desarrollador Internacional

Crear rápidamente archivos README en chino e inglés para proyectos dirigidos tanto a audiencias nacionales como internacionales.

Distribución de Código de Investigación

Producir documentación profesional para versiones de software académico con estructura de secciones clara e instrucciones de instalación.

Prueba estos prompts

Generación Básica de README

Generar archivos README bilingües para mi repositorio usando la plantilla predeterminada.

Configuración Personalizada

Crear README.md y README.zh.md usando la configuración en release_assistant.json para el nombre del proyecto, características y pasos de inicio rápido.

Salida de Idioma Selectivo

Generar solo el README en chino (README.zh.md) usando los metadatos existentes del proyecto y sobrescribir si los archivos existen.

Flujo de Trabajo Completo de Versión

Generar ambos archivos README, mostrarme el git diff, luego guiarme a través de confirmar y subir los cambios con un mensaje de commit apropiado.

Mejores prácticas

Revisar el contenido del README generado antes de confirmar para asegurar la precisión de los metadatos extraídos
Crear release_assistant.json con detalles personalizados del proyecto para salida consistente entre versiones
Usar git diff para previsualizar cambios antes de ejecutar operaciones de git add y commit

Evitar

No confirmar archivos README generados sin revisar el contenido extraído para mayor precisión
Evitar usar el flag --overwrite a menos que pretendas reemplazar la documentación existente completamente
No ejecutar git push sin primero verificar que el diff muestre solo los cambios de documentación previstos

Preguntas frecuentes

¿Qué archivos necesita esta habilidad para generar documentación?

La habilidad lee config.json, README.md, PROJECT_STRUCTURE.md, requirements.txt y LICENSE de tu repositorio. Como mínimo necesita un directorio de repositorio para extraer el nombre del proyecto.

¿Puedo personalizar la plantilla de README?

Sí, edita los archivos de plantilla en assets/readme_template_en.md y assets/readme_template_zh.md o proporciona plantillas personalizadas vía --template-dir flag.

¿Esta habilidad crea versiones reales de GitHub?

No, solo genera archivos de documentación README. Crear versiones de GitHub vía API requiere permisos adicionales y está fuera del alcance de esta habilidad.

¿Cómo maneja la habilidad el contenido bilingüe?

Detecta caracteres chinos/japoneses/coreanos usando regex y extrae contenido de documentación existente, o usa valores de configuración proporcionados para secciones tanto en inglés como en chino.

¿Qué pasa si mi proyecto usa un formato de configuración diferente?

Crea un archivo release_assistant.json en la raíz de tu repositorio siguiendo el ejemplo en assets/release_config.example.json para proporcionar metadatos personalizados.

¿Mi código se envía a servidores externos durante la generación?

No, todo el procesamiento ocurre localmente. Las únicas URLs externas son imágenes de insignias estáticas de shields.io incrustadas en el markdown del README generado.