SpeakingColors/claude-skills - GitHub para principiantes

GitHub para principiantes

Habilidad comunitaria no oficial. Los hechos se verifican con la documentación oficial de GitHub cuando está marcada (V). No es asesoramiento legal.

Estilo (seguir estrictamente)

• Asume que el usuario no sabe nada y no quiere aprender Git. Quiere el resultado.
• Da un paso a la vez. Menciona el nombre exacto del botón o enlace que verá. Espera a que el usuario diga que lo ha hecho antes de dar el siguiente paso.
• Empieza con un resumen de una línea. Solo da detalles cuando se te pidan.
• Si el usuario envía una captura de pantalla, léela e indica dónde está antes de la siguiente instrucción.
• Si tú (el asistente) puedes hacer el paso con acceso al repositorio, ofrécete a hacerlo. Solicita acceso a través de la herramienta adecuada o el flujo de inicio de sesión. Nunca le pidas que pegue una contraseña o token de acceso en el chat.

1. Crear un repositorio

1. Haz clic en el + en la esquina superior derecha de github.com, luego en Nuevo repositorio.
2. Nombre: corto, minúsculas, guiones (por ejemplo mi-plugin).
3. Elige Público (cualquiera puede verlo) o Privado.
4. Marca Añadir un README. Elige una licencia del menú desplegable (consulta la sección 5).
5. Haz clic en Crear repositorio.

Un repositorio vacío muestra una página de "Configuración rápida" con cajas de línea de comandos. Un principiante puede ignorar todo eso y usar el enlace "subir un archivo existente" en su lugar.

2. Poner archivos en el repositorio (web, sin Git)

En la página del repositorio: Añadir archivo, luego Subir archivos. Luego arrastra archivos o haz clic en "elige tus archivos".

Límites (V: docs de GitHub, Adding a file to a repository):

• 25 MiB por archivo al subir en el navegador.
• Hasta 100 archivos por subida.
• Archivos más grandes, hasta 100 MiB cada uno, necesitan la línea de comandos; archivos de más de 100 MiB necesitan Git Large File Storage.
• Una rama protegida no se puede editar mediante la subida web.
• La protección de push puede bloquear un archivo que contenga un secreto compatible, como un token.

Carpetas: la documentación dice que puedes arrastrar un archivo o carpeta. Si el navegador del usuario no acepta una carpeta, usa una de estas alternativas:

• Crear la carpeta en el editor web: Añadir archivo, Crear nuevo archivo, escribe nombrecarpeta/nombrearchivo.md en el cuadro de nombre (escribir la barra crea la carpeta), añade contenido, luego haz commit. Verifica el comportamiento en la interfaz actual.
• Descomprime la carpeta y sube los archivos en lotes que mantengan sus rutas de carpeta, o usa GitHub Desktop.
• Deja que el asistente suba los archivos si tiene acceso al repositorio.

Los archivos zip se almacenan como un solo archivo; GitHub no los descomprime. Sube los contenidos descomprimidos.

Termina con un mensaje de commit (corto, qué cambió) y el botón Confirmar cambios.

Verifica el resultado: abre la página del repositorio y compara la lista de archivos con lo esperado. Error común: los archivos caen en la raíz en lugar de en su carpeta.

3. Lanzamientos con descargas (lo que los usuarios deben descargar)

Un lanzamiento es una página de descarga etiquetada basada en una etiqueta de Git (V: docs de GitHub, About releases).

1. En la página del repositorio haz clic en Lanzamientos (lado derecho), luego en Redactar un nuevo lanzamiento.
2. Elige una etiqueta como v1.0.0 (escribe una nueva, luego Crear nueva etiqueta).
3. Título y notas: qué es, cómo instalar en tres pasos, qué cambió.
4. Arrastra los archivos al cuadro de activos. Los lanzamientos aptos para principiantes incluyen un instalador compilado o un archivo por sistema operativo, un manual corto e instrucciones de instalación, no solo un archivo simple o el código fuente.
5. Haz clic en Publicar lanzamiento.

Límites (V): cada archivo menor de 2 GiB, hasta 1000 activos por lanzamiento, sin límite en tamaño total o ancho de banda.

Plantilla de notas de lanzamiento:

• Qué es (una línea)
• Descargar: elige tu sistema (Windows, macOS, Linux)
• Instalar en tres pasos
• Sumas de verificación (SHA-256) para cada archivo
• Problemas conocidos

4. Licencia y conceptos básicos del README

• Un repositorio sin licencia no es código abierto; otros no tienen derecho a reutilizarlo. Elige una deliberadamente.
• MIT: muy permisiva, corta. AGPL-3.0 o GPL: copyleft. Los proyectos basados en JUCE bajo su opción de código abierto están cubiertos por AGPLv3 (V: foro de JUCE, personal), así que verifica la licencia actual de JUCE antes de elegir.
• Nunca publiques archivos de proveedores (manuales, ajustes preestablecidos de fábrica, logotipos, binarios) de los que no poseas los derechos. Enlázalos en su lugar.
• El README debe responder: qué es, cómo instalar, cómo usar, licencia, cómo reportar problemas.

5. Mantener la información privada fuera (lo más importante)

Antes del primer push público, revisa cada archivo y la identidad del commit en busca de: nombre real, correo electrónico personal, teléfono, dirección, empleador, tokens, contraseñas, rutas locales con el nombre de usuario.

Identidad del commit:

• Usa la dirección de noreply de GitHub, que se muestra en Configuración, Correos electrónicos, con "Mantener mis direcciones de correo electrónico privadas" marcado. Formato: <id numérica>+<nombre de usuario>@users.noreply.github.com.
• Establécelo antes de hacer commit: git config user.name "<nombre de usuario>" y git config user.email "<id>+<nombre de usuario>@users.noreply.github.com". Verifica con git log --format='%an <%ae>' antes de hacer push.
• Cuando un asistente haga commit por el usuario, debe usar esta identidad y nunca el correo real del usuario.

Si los datos privados ya se hicieron públicos (V: docs de GitHub, Removing sensitive data from a repository):

1. Si es una credencial, revócala o cámbiala primero. Eso puede ser suficiente por sí solo.
2. Reescribe el historial localmente con git-filter-repo (versión 2.47 o posterior para --sensitive-data-removal). Elimina un archivo con --invert-paths --path, o reemplaza texto con --replace-text.
3. Haz force push para sobrescribir el repositorio en GitHub.
4. Contacta al Soporte de GitHub para eliminar las vistas en caché y las referencias de solicitudes de extracción; proporciona el nombre del repositorio, el número de PR afectadas y los primeros commits cambiados de la salida de la herramienta.
5. Los forks mantienen los datos; pide a los propietarios del fork que los eliminen. Los colaboradores deben hacer rebase, no merge.
6. Advertencia de la documentación: los clones de otras personas mantienen los datos, y una reescritura puede revelar lo que se eliminó. Asume que los datos fueron vistos.

Modificar un commit reciente solo es suficiente para la punta de la rama; el commit antiguo aún puede ser accesible por su enlace directo hasta que GitHub lo limpie, por lo que el paso 4 sigue siendo aplicable.

5b. Elegir qué se hace público

• Las notas de investigación, los datos capturados del dispositivo, las notas personales y las transcripciones de chat no pertenecen a un repositorio público a menos que el usuario lo indique.
• Pregunta antes de publicar cualquier cosa que no haya sido escrita para el público.

6. Tareas cotidianas (una a la vez)

• Editar un archivo en la web: ábrelo, icono del lápiz, cambia, Confirmar cambios.
• Eliminar un archivo: ábrelo, tres puntos, Eliminar archivo, haz commit.
• Renombrar o mover: edita el cuadro del nombre del archivo, escribiendo la nueva ruta; haz commit.
• Fijar un repositorio al perfil: página de perfil, Personalizar tus pines.
• Habilitar una página web del proyecto (GitHub Pages): Configuración, Pages, elige la rama y la carpeta. Verifica la interfaz actual.
• Reportar o rastrear problemas: pestaña Issues. Ofrece una plantilla de issue para informes de errores.

7. Cuando algo falla

• Subida rechazada: verifica el tamaño del archivo (límite web de 25 MiB), número de archivos (100) y rama protegida.
• Carpeta faltante: los archivos se subieron planos; recrea la ruta con Crear nuevo archivo o vuelve a subir.
• Push rechazado con advertencia de secreto: elimina el secreto, cámbialo e inténtalo de nuevo.
• Nunca sugieras deshabilitar las indicaciones de seguridad.

Fuentes

• Docs de GitHub, Adding a file to a repository: https://docs.github.com/en/repositories/working-with-files/managing-files/adding-a-file-to-a-repository
• Docs de GitHub, About releases: https://docs.github.com/en/repositories/releasing-projects-on-github/about-releases
• Docs de GitHub, Removing sensitive data from a repository: https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/removing-sensitive-data-from-a-repository