Communitygithub.com

tangshengming/personal_website

Genera un primer sitio web personal a partir de un CV o fuente de perfil extrayendo contenido estructurado, escribiendo archivos Markdown revisables, confirmando decisiones de privacidad/audiencia/diseño, esbozando la estructura del sitio, creando un sitio Astro y verificándolo localmente. Úsalo cuando el usuario solicite generar un sitio web, construir un sitio web personal desde un CV, convertir un CV en PDF/LaTeX en un portafolio o reproducir el flujo de trabajo de CV a sitio web.

¿Qué es personal_website?

Esta habilidad implementa un flujo de trabajo cuidadoso para transformar un CV (en formatos como PDF, LaTeX, DOCX o Markdown) en un sitio web personal funcional. En lugar de generar páginas directamente, prioriza la creación de material fuente revisable: primero extrae el CV a Markdown estructurado, luego confirma con el usuario qué información es pública o privada y las preferencias de diseño, y finalmente construye el sitio web utilizando Astro como framework predeterminado. Soporta múltiples formatos de entrada y plataformas de desarrollo (Windows, Linux, macOS). El flujo incluye pasos como inspeccionar el espacio de trabajo, extraer contenido, redactar la estructura del sitio, crear la aplicación Astro con contenido separado de la interfaz, y verificar localmente con construcción y previsualización. Es ideal para desarrolladores y profesionales que desean un portafolio web rápido, estructurado y con control de privacidad, evitando la exposición accidental de datos sensibles.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tangshengming/personal_website/tree/HEAD/.codex/skills/generate-website

Preguntar en tu IA favorita

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

Documentación

Generar Sitio Web

Resumen

Usa esta habilidad para reproducir un flujo de trabajo cuidadoso de CV a sitio web. El principio clave es crear material fuente revisable antes de generar páginas: primero extrae el CV a Markdown, luego decide qué es público, y después construye el sitio web a partir de contenido estructurado.

Flujo de Trabajo

1. Inspeccionar el Espacio de Trabajo

Revisa los archivos del proyecto actual antes de editar:

  • Busca archivos de estado del flujo de trabajo como WEBSITE_WORKFLOW.md, PROJECT_STATUS.md o similares.
  • Encuentra el archivo fuente del CV/perfil: normalmente .pdf, .tex, .docx o un CV en texto/Markdown.
  • Verifica si ya existe un sitio web: package.json, astro.config.*, src/, public/, dist/.
  • Revisa ligeramente el estado de Git con git status --short cuando sea útil.

No asumas que el proyecto está vacío.

2. Leer e Inspeccionar el CV

Si la fuente es un PDF:

  • Usa la habilidad de PDF.
  • Extrae el texto con pdfplumber u otra herramienta de texto PDF confiable.
  • Renderiza las páginas a imágenes cuando sea posible e inspecciónalas visualmente para no malinterpretar el diseño y los límites de las secciones.
  • Espera que la extracción de texto PDF tenga artefactos de espaciado/iconos; límpialos manualmente en la salida estructurada.

Si la fuente es LaTeX:

  • Lee el archivo .tex directamente.
  • Trata los comandos de sección, macros y listas como estructura.
  • No requieras compilación local de LaTeX a menos que el usuario solicite regenerar el PDF.

Si la fuente es .docx:

  • Usa la habilidad de documentos para extraer estructura y contenido.

3. Extraer a Markdown Revisable

Crea un archivo Markdown fuente antes de construir las páginas del sitio web. Prefiere:

content/cv_extracted.md

Incluye secciones estructuradas como:

  • Identidad
  • Contacto público
  • Contacto/detalles privados u ocultos
  • Perfil
  • Idiomas
  • Experiencia técnica
  • Habilidades profesionales
  • Experiencia laboral
  • Educación
  • Publicaciones
  • Proyectos
  • Potencial de presentación web para cada proyecto

Mantén este archivo factual. Es el material fuente, no el texto de marketing final.

4. Preguntar o Confirmar Decisiones Públicas/Privadas

Antes de poner detalles personales en un sitio web público, confirma:

  • Correo electrónico público
  • Si mostrar el número de teléfono
  • Si mostrar la fecha de nacimiento
  • Si mostrar la dirección completa
  • Si mostrar detalles de residencia/permiso/visa/licencia
  • Qué enlaces son públicos u ocultos: GitHub, LinkedIn, Google Scholar, ORCID, ResearchGate, etc.
  • Audiencia preferida: industria, academia, mixta, clientes, reclutadores, colaboradores
  • Preferencia visual: minimalista, académica, portafolio técnico expresivo, etc.

Postura de privacidad predeterminada:

  • Oculta fecha de nacimiento, número de teléfono, dirección completa, permiso de residencia, licencia de conducir y detalles sensibles similares a menos que el usuario los quiera explícitamente públicos.
  • Prefiere correo electrónico público, ciudad/país y enlaces profesionales seleccionados.

5. Redactar la Estructura del Sitio Web

Crea un borrador de estructura antes de comenzar a construir o editar páginas intensivamente. Prefiere:

WEBSITE_STRUCTURE_DRAFT.md

Incluye:

  • Dirección de diseño
  • Audiencia prevista
  • Navegación
  • Lista de páginas
  • Propósito de cada página
  • Contenido sugerido por página
  • Preguntas o decisiones abiertas
  • Recomendación técnica

Una buena primera estructura:

  • Inicio
  • Acerca de
  • CV
  • Proyectos
  • Contacto

Para perfiles con mucha investigación, deja espacio para páginas de presentación académica web posteriores.

6. Crear el Sitio Web

Usa Astro por defecto para un sitio web personal con mucho contenido a menos que el usuario solicite otra pila.

Estructura sugerida:

src/
  pages/
    index.astro
    about.astro
    cv.astro
    projects.astro
    contact.astro
  content/
    profile.ts
    projects.ts
  layouts/
    BaseLayout.astro
  styles/
    global.css
public/

Construye el contenido del sitio web a partir de archivos fuente estructurados, no esparciendo texto del CV codificado en todas partes.

Archivos de contenido recomendados:

  • src/content/profile.ts para identidad, perfil, experiencia, educación, publicaciones.
  • src/content/projects.ts para entradas de proyectos y notas de presentación posteriores.

Copia activos públicos en public/:

  • CV en PDF, si el usuario quiere un CV descargable.
  • Imagen de retrato, si está disponible y aprobada.
  • Imágenes o figuras de proyectos más adelante.

7. Diseñar la Primera Versión

Para un primer sitio personal:

  • Haz que la primera pantalla sea la identidad/perfil real, no una página de aterrizaje de marketing.
  • Utiliza activos visuales reales cuando estén disponibles.
  • Mantén la información de contacto consciente de la privacidad.
  • Construye páginas que se puedan escanear rápidamente pero que se puedan expandir más adelante.
  • Para audiencias de la industria, enfatiza la utilidad en ingeniería, flujos de trabajo de I+D, profundidad técnica y capacidades transferibles.
  • Para audiencias académicas, enfatiza preguntas de investigación, métodos, publicaciones y flujo de presentación.

Evita sobreajustar la primera versión. Deja lugares claros para futuras páginas de presentación de proyectos.

8. Verificar Localmente

Ejecuta:

npm.cmd install
npm.cmd run build
npm.cmd run dev

En Windows/PowerShell, prefiere npm.cmd si npm está bloqueado por la política de ejecución de scripts.

Si la telemetría de Astro intenta escribir fuera del espacio de trabajo, configura scripts en package.json como:

"dev": "set ASTRO_TELEMETRY_DISABLED=1&& astro dev",
"build": "set ASTRO_TELEMETRY_DISABLED=1&& astro build",
"preview": "set ASTRO_TELEMETRY_DISABLED=1&& astro preview"

Verifica:

  • La construcción se completa correctamente.
  • Las rutas locales devuelven 200.
  • Los activos públicos se cargan.
  • No se muestran accidentalmente detalles sensibles.
  • Se realiza una revisión visual en el navegador cuando esté disponible, o el usuario revisa manualmente.

9. Actualizar Archivos de Estado y Readme

Actualiza un archivo de estado/dashboard si el proyecto lo usa, por ejemplo:

PROJECT_STATUS.md

Archivos de soporte útiles:

  • readme_website.txt: cómo editar, previsualizar, construir y enviar el sitio web.
  • readme_git.txt: configuración de Git y comandos comunes.
  • WEBSITE_WORKFLOW.md: flujo de trabajo a largo plazo.

Mantén el estado conciso. No agregues detalles ruidosos de Git a menos que el usuario lo solicite.

Expectativas de Salida

Al final de la primera iteración, el proyecto debe tener:

  • Markdown del CV extraído.
  • Borrador de la estructura del sitio web.
  • Un sitio Astro funcional.
  • Contenido separado del código de página/diseño.
  • Una construcción exitosa.
  • Una URL de previsualización local.
  • Notas claras sobre lo que queda pendiente.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Skills relacionados