majiayu000/claude-skill-registry

Agregar Miembro del Laboratorio

Esta habilidad te guía para agregar un nuevo miembro del laboratorio al sitio web con el formato adecuado, redacción de biografía y manejo de imágenes.

Cuándo Usar Esta Habilidad

Usa esta habilidad cuando:

• "Agregar un nuevo miembro del laboratorio"
• "Crear un perfil para [nombre]"
• "Agregar a [nombre] a la página del equipo"
• "Actualizar el rol de [nombre]"
• "Marcar a [nombre] como exalumno"
• Cualquier solicitud que implique agregar o actualizar perfiles de miembros del equipo

Flujo de Trabajo Interactivo

Paso 1: Recopilar Información Básica

Pregunta al usuario los detalles esenciales:

Obligatorio:

• Nombre completo
• Rol (pi, postdoc, staff, phd, ms, ra, programmer, undergrad, highschool)

Opcional (investigaremos si no se proporciona):

• Dirección de correo electrónico
• Nombre de usuario de GitHub
• Perfil de LinkedIn
• Sitio web personal
• Institución/programa actual (si es estudiante)

Usa AskUserQuestion para recopilar esta información si no se proporciona en la solicitud inicial.

Paso 2: Investigación Web

Realiza investigación web para recopilar información de antecedentes:

1. Busca en LinkedIn información sobre educación e historial laboral

   • Consulta: "[Nombre Completo] LinkedIn [institución si se conoce]"
   • Extrae: títulos, instituciones, cargos anteriores

2. Busca en GitHub el nombre de usuario y proyectos

   • Consulta: "[Nombre Completo] GitHub [dominio de correo si se conoce]"
   • Extrae: nombre de usuario, repositorios notables

3. Busca en páginas institucionales información para la biografía

   • Consulta: "[Nombre Completo] [institución] neurociencia/biología/ciencias de la computación"
   • Extrae: intereses de investigación, trabajo actual

4. Busca publicaciones si corresponde (doctorado/postdoc)

   • Consulta: "[Nombre Completo] [institución] publicaciones"
   • Extrae: áreas de investigación

Presenta los hallazgos al usuario:

• Muestra lo que encontraste
• Pregunta al usuario que confirme la exactitud
• Pide aclaración sobre cualquier cosa que no esté clara
• Solicita cualquier información crítica faltante

Paso 3: Redactar Biografía

Utilizando la información recopilada y la plantilla adecuada según el rol:

1. Determina la longitud de la biografía según el rol:

   • PI: 250-300 palabras (detallada)
   • Doctorado/Postdoc/Staff: 100-150 palabras
   • MS/RA/Programmer: 80-120 palabras
   • Undergrad: 80-100 palabras
   • Alumni: 50-250 palabras (según la antigüedad y logros)

2. Sigue la plantilla de biografía del directorio templates/:

   • Usa voz en tercera persona
   • Tono profesional y académico
   • Incluye: educación, fecha de ingreso, enfoque de investigación/trabajo actual
   • Menciona co-tutores si corresponde
   • Destaca experiencia previa si es relevante
   • Menciona premios/becas si son notables

3. Presenta el borrador al usuario:

   • Muestra la biografía redactada
   • Pregunta si desea hacer alguna edición
   • Refina según los comentarios

Paso 4: Manejar la Imagen de Perfil

1. Pregunta al usuario por la imagen:

   • "¿Tienes una foto de perfil para [nombre]?"
   • Si sí: "Por favor, proporciona la ruta al archivo de imagen"
   • Si no: "Podemos usar un marcador de posición por ahora y agregarlo después"

2. Si se proporciona imagen, valida y optimiza:

   • Verifica el tamaño del archivo y las dimensiones usando file o sips
   • Especificaciones objetivo: 100-250 KB, relación de aspecto razonablemente cuadrada
   • Si es demasiado grande (>500 KB) o la relación de aspecto es incorrecta:
     • Ofrece redimensionar/optimizar usando scripts/optimize-image.sh
     • Usa sips (macOS) o convert (ImageMagick) si están disponibles

3. Genera el nombre del archivo de imagen:

   • Formato: nombre-apellido.jpg
   • Asegúrate de que no haya espacios ni caracteres especiales
   • Copia al directorio images/ con el nombre correcto

Paso 5: Generar el Archivo del Miembro

1. Crea el nombre del archivo: _members/nombre-apellido.md

2. Construye el frontmatter:

   ---
   name: [Nombre Completo]
   image: images/[nombre-apellido].jpg
   role: [rol]
   description: [Texto de visualización del rol de roles.yaml]
   links:
     email: [correo si se proporciona]
     github: [nombre de usuario si se encuentra/proporciona]
     linkedin: [perfil si se encuentra/proporciona]
     home-page: [url si se proporciona]
   ---
   

   • Solo incluye los enlaces que están disponibles
   • Elimina los campos de enlace vacíos

3. Agrega el texto de la biografía (del Paso 3)

4. Escribe el archivo en _members/nombre-apellido.md

Paso 6: Manejar Exalumnos (si corresponde)

Si el rol es alumni O el usuario indica que esta persona se va:

1. Pregunta por los detalles del exalumno:

   • Año en que se fueron/se van
   • Su rol mientras estuvieron en el laboratorio (si es diferente del actual)
   • Posición "Siguiente" (a dónde van)

2. Actualiza team/index.md:

   • Lee la sección actual de exalumnos
   • Agrega la entrada en orden cronológico (más reciente primero):

     - AÑO: [**Nombre**](/members/nombre-apellido.html) (Descripción del Rol). **Siguiente:** [Próxima posición]
     

   • Mantén el formato adecuado

Paso 7: Validar

Ejecuta comprobaciones de validación:

• El archivo del miembro existe en _members/nombre-apellido.md
• El frontmatter YAML es válido
• El rol es válido (verificar contra roles.yaml)
• El archivo de imagen existe (o se anota como marcador de posición)
• La biografía tiene la longitud adecuada para el rol
• La biografía usa voz en tercera persona
• Los enlaces tienen el formato correcto
• Si es exalumno: team/index.md está actualizado

Paso 8: Presentar Resumen

Muestra al usuario lo que se creó:

✓ Perfil de miembro creado para [Nombre]
✓ Archivo: _members/nombre-apellido.md
✓ Rol: [texto de visualización del rol]
✓ Imagen: images/nombre-apellido.jpg [o "Marcador de posición - agregar después"]
✓ Enlaces: [lista de enlaces incluidos]
[✓ Lista de exalumnos actualizada] [si corresponde]

Vista previa de la biografía:
[Primeros 100 caracteres de la biografía]...

¿Te gustaría que te muestre el contenido completo del archivo?

Paso 9: Confirmar Opcionalmente

Pregunta al usuario si desea confirmar los cambios:

• Si sí: Crea un commit de git con el mensaje adecuado
• Si no: Deja los cambios sin preparar para revisión manual

Pautas para la Redacción de Biografías

Voz y Tono

• Siempre en tercera persona: "Jane es estudiante de doctorado..." (no "Soy...")
• Profesional y académico: Formal pero no rígido
• Orientado a logros y hechos: Enfócate en las credenciales y el trabajo
• Tiempo presente para el trabajo actual: "trabajando en", "desarrollando", "investigando"
• Tiempo pasado para los antecedentes: "recibió", "trabajó", "se unió"

Elementos Esenciales

Todos los miembros deben incluir:

1. Rol actual e institución
2. Cuándo se unieron (mes y año)
3. Antecedentes educativos (título, especialidad, institución)
4. Enfoque de investigación/trabajo actual

Elementos adicionales según el rol:

PI:

• Institución de doctorado y asesores (con hipervínculos)
• Filosofía y enfoque de investigación
• Publicaciones notables o cobertura mediática
• Cargos anteriores
• Premios y distinciones importantes

Doctorado/Postdoc:

• Institución de pregrado y/o maestría
• Intereses de investigación específicos
• Co-tutores si corresponde
• Experiencia investigativa previa si es notable

Staff/Programmer:

• Experiencia laboral previa (industrial o académica)
• Experiencia técnica y áreas de enfoque
• Proyectos en los que están trabajando
• Nombramientos conjuntos si corresponde

Estudiantes (MS/Undergrad):

• Especialidad y año
• Intereses de investigación
• Prácticas o investigación previas si corresponde
• Premios/becas si son notables

Exalumnos:

• Todo lo anterior según su rol
• Mentores (especialmente para internos de corto plazo)
• Logros durante su tiempo en el laboratorio
• Mantén conciso para internos de verano (50-80 palabras)

Qué Evitar

• Narrativa en primera persona (excepto posiblemente la introducción del PI)
• Detalle excesivo sobre proyectos (limítate a 1-2 oraciones)
• Tiempo futuro o especulación
• Lenguaje informal o jerga
• Información personal no relacionada con la investigación
• Redundancia con el frontmatter (nombre, rol ya se muestran)

Detalles del Manejo de Imágenes

Especificaciones Preferidas

• Formato: JPG (preferido) o PNG
• Tamaño: 100-250 KB para optimización web
• Relación de aspecto: Cuadrada o casi cuadrada (1:1 o 4:5)
• Dimensiones mínimas: 300x300 píxeles
• Recomendado: 400x400 a 600x600 píxeles
• Color: Espacio de color RGB

Proceso de Optimización

Si la imagen necesita optimización:

# Usar el script incluido
bash .claude/skills/add-member/scripts/optimize-image.sh entrada.jpg salida.jpg 500

O manualmente con sips (macOS):

# Redimensionar a 500px de dimensión máxima, manteniendo la relación de aspecto
sips -Z 500 entrada.jpg --out salida.jpg

# Convertir PNG a JPG
sips -s format jpeg entrada.png --out salida.jpg

O con ImageMagick:

# Redimensionar y optimizar
convert entrada.jpg -resize 500x500^ -quality 85 salida.jpg

Convención de Nombres de Archivos

• Usa kebab-case: nombre-apellido.jpg
• Sin espacios, caracteres especiales ni mayúsculas
• Debe coincidir con el slug del archivo del miembro
• Ejemplos: jane-doe.jpg, john-smith.jpg

Notas Específicas del Rol

Agregar Exalumnos

Al agregar a alguien que ya se ha ido:

1. Establece role: alumni en el frontmatter
2. Incluye su rol real en el texto de la biografía
3. Actualiza la sección de exalumnos en team/index.md con:
   • Año en que se fueron
   • Descripción del rol entre paréntesis
   • Anotación "Siguiente:" si se conoce

Manejo de Co-tutores

Cuando el miembro tiene un co-tutor:

1. Menciónalo en la biografía: "co-tutorizado por [Nombre]"
2. Incluye hipervínculo si es posible: [Nombre](url)
3. Anótalo en el resumen al presentarlo al usuario

Nombramientos Conjuntos

Cuando el miembro tiene una afiliación conjunta:

1. Menciónalo en la biografía: "conjuntamente con el [Nombre del Laboratorio]"
2. Incluye hipervínculo al otro laboratorio si está disponible
3. Indica claramente los IP colaboradores

Estudiantes que Transicionan de Rol

Cuando un estudiante pasa de undergrad → MS → doctorado:

1. ¿Crear un nuevo archivo de miembro? No - mantén el mismo archivo
2. Actualiza el campo role: en el frontmatter
3. Actualiza la biografía para reflejar el nuevo estado
4. Actualiza el campo description:
5. Considera agregar una nota sobre la transición en la biografía

Internos de Verano

Miembros de corto plazo (2-3 meses):

1. Mientras están activos: Agréguelos con el rol undergrad o highschool
2. Cuando se van: Cambia a role: alumni
3. Biografía: Puede ser breve (50-80 palabras) pero destaca:
   • Institución y programa
   • En qué trabajaron
   • Quién los mentorizó
   • Cualquier logro notable

Manejo de Errores

Si la búsqueda web no encuentra nada:

• Pide al usuario que proporcione la información directamente
• Ofrece redactar una biografía mínima y dejar que ellos la amplíen

Si la imagen tiene el formato/tamaño incorrecto:

• Ofrece optimizar usando las herramientas proporcionadas
• Si las herramientas no están disponibles, proporciona instrucciones manuales
• En el peor caso, usa un marcador de posición y anótalo en el resumen

Si no estás seguro sobre el rol:

• Presenta las opciones de rol de roles.yaml
• Usa AskUserQuestion para aclarar

Si existe un miembro duplicado:

• Verifica si es una actualización o un miembro nuevo
• Pregunta al usuario si desea actualizar el existente o crear uno nuevo

Lista de Verificación de Validación

Antes de finalizar, verifica:

• El nombre completo coincide en el nombre del archivo, frontmatter y biografía
• El rol es válido (uno de: pi, postdoc, staff, phd, ms, ra, programmer, undergrad, highschool, alumni)
• El nombre del archivo de imagen sigue la convención (kebab-case, .jpg)
• La biografía está en tercera persona en todo momento
• La longitud de la biografía es adecuada para el rol (ver pautas)
• Se menciona la fecha de ingreso en la biografía (mes y año)
• Se incluyen los antecedentes educativos
• Todos los enlaces tienen el formato correcto
• El frontmatter YAML es válido (probar con un analizador)
• Si es exalumno: team/index.md actualizado correctamente
• Sin espacios en blanco al final ni problemas de formato

Ver También

• reference.md - Documentación detallada sobre el formato de archivos de miembros y patrones
• examples.md - Flujos de trabajo de ejemplo para diferentes escenarios
• templates/ - Plantillas de biografía para cada tipo de rol