Communitygithub.com

tangshengming/personal_website

Gere um primeiro site pessoal a partir de um CV ou fonte de perfil, extraindo conteúdo estruturado, escrevendo arquivos Markdown revisáveis, confirmando decisões de privacidade/público/design, esboçando a estrutura do site, montando um site Astro e verificando localmente. Use quando o usuário pedir para gerar um site, construir um site pessoal a partir de um CV, converter um CV em PDF/LaTeX em um site portfólio, ou reproduzir o fluxo de trabalho de CV para site.

O que é personal_website?

Esta skill automatiza o fluxo de trabalho completo de criação de um site pessoal a partir de um currículo (CV) ou perfil, seguindo uma abordagem cuidadosa e estruturada para garantir qualidade e privacidade. Ela é projetada para usuários que desejam converter um CV em PDF, LaTeX, DOCX ou Markdown em um site pronto para produção, utilizando o framework Astro. A skill foca em criar material de origem revisável (arquivos Markdown) antes de gerar as páginas, garantindo que o conteúdo seja verificado e as decisões de privacidade (como ocultar dados sensíveis) sejam tomadas de forma explícita. O processo inclui a extração estruturada do CV, a elaboração de um rascunho da estrutura do site, a montagem do projeto Astro com separação clara entre conteúdo e código, e a verificação local do build e das rotas. É útil para desenvolvedores, acadêmicos e profissionais que querem construir rapidamente um site pessoal sem comprometer a qualidade ou expor informações desnecessárias.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Gerar Site

Visão Geral

Use esta skill para reproduzir um fluxo de trabalho cuidadoso de CV para site. O princípio chave é criar material de origem revisável antes de gerar as páginas: primeiro extraia o CV para Markdown, depois decida o que é público e, em seguida, construa o site a partir do conteúdo estruturado.

Fluxo de Trabalho

1. Inspecionar o Espaço de Trabalho

Verifique os arquivos atuais do projeto antes de editar:

  • Encontre arquivos de status do fluxo de trabalho, como WEBSITE_WORKFLOW.md, PROJECT_STATUS.md ou similares.
  • Encontre o arquivo de CV/perfil fonte: geralmente .pdf, .tex, .docx, ou um CV em texto/Markdown.
  • Verifique se um site já existe: package.json, astro.config.*, src/, public/, dist/.
  • Verifique o estado do Git levemente com git status --short quando útil.

Não presuma um projeto em branco.

2. Ler e Inspecionar o CV

Se a fonte for um PDF:

  • Use a skill de PDF.
  • Extraia texto com pdfplumber ou outra ferramenta confiável de extração de texto de PDF.
  • Renderize páginas como imagens quando possível e inspecione-as visualmente para que o layout e os limites das seções não sejam interpretados erroneamente.
  • Espere que a extração de texto de PDF tenha artefatos de espaçamento/ícones; limpe-os manualmente na saída estruturada.

Se a fonte for LaTeX:

  • Leia o arquivo .tex fonte diretamente.
  • Trate comandos de seção, macros e listas como estrutura.
  • Não exija compilação LaTeX local a menos que o usuário peça regeneração de PDF.

Se a fonte for .docx:

  • Use a skill de documentos para extrair estrutura e conteúdo.

3. Extrair para Markdown Revisável

Crie um arquivo Markdown fonte antes de construir as páginas do site. Prefira:

content/cv_extracted.md

Inclua seções estruturadas como:

  • Identidade
  • Contato público
  • Contato/detalhes privados ou ocultos
  • Perfil
  • Idiomas
  • Expertise técnica
  • Habilidades profissionais
  • Experiência profissional
  • Educação
  • Publicações
  • Projetos
  • Potencial de apresentação no site para cada projeto

Mantenha este arquivo factual. É o material de origem, não uma cópia de marketing final.

4. Perguntar ou Confirmar Decisões de Público/Privado

Antes de colocar detalhes pessoais em um site público, confirme:

  • E-mail público
  • Se deve mostrar número de telefone
  • Se deve mostrar data de nascimento
  • Se deve mostrar endereço completo
  • Se deve mostrar detalhes de residência/autorização/visto/carteira de motorista
  • Quais links são públicos ou ocultos: GitHub, LinkedIn, Google Scholar, ORCID, ResearchGate, etc.
  • Público-alvo preferido: indústria, academia, misto, clientes, recrutadores, colaboradores
  • Preferência visual: minimalista, acadêmico, portfólio técnico expressivo, etc.

Postura de privacidade padrão:

  • Oculte data de nascimento, número de telefone, endereço completo, autorização de residência, carteira de motorista e detalhes sensíveis similares, a menos que o usuário explicitamente queira torná-los públicos.
  • Prefira e-mail público, cidade/país e links profissionais selecionados.

5. Esboçar a Estrutura do Site

Crie um rascunho de estrutura antes de montar ou editar intensamente as páginas. Prefira:

WEBSITE_STRUCTURE_DRAFT.md

Inclua:

  • Direção de design
  • Público-alvo
  • Navegação
  • Lista de páginas
  • Propósito da página
  • Conteúdo sugerido por página
  • Perguntas ou decisões em aberto
  • Recomendação técnica

Uma boa primeira estrutura:

  • Início
  • Sobre
  • CV
  • Projetos
  • Contato

Para perfis com forte foco em pesquisa, deixe espaço para páginas acadêmicas de apresentação web posteriores.

6. Montar o Site

Use Astro por padrão para um site pessoal com foco em conteúdo, a menos que o usuário solicite outra pilha.

Estrutura 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/

Construa o conteúdo do site a partir de arquivos fonte estruturados, não espalhando texto de CV codificado manualmente por toda parte.

Arquivos de conteúdo recomendados:

  • src/content/profile.ts para identidade, perfil, expertise, experiência, educação, publicações.
  • src/content/projects.ts para entradas de projetos e notas de apresentação posteriores.

Copie ativos públicos para public/:

  • CV em PDF, se o usuário quiser um CV para download.
  • Imagem de retrato, se disponível e aprovada.
  • Imagens de projetos ou figuras posteriormente.

7. Projetar a Primeira Versão

Para um primeiro site pessoal:

  • Faça a primeira tela ser a identidade/perfil real, não uma página de destino de marketing.
  • Use ativos visuais reais quando disponíveis.
  • Mantenha as informações de contato com consciência de privacidade.
  • Construa páginas que possam ser escaneadas rapidamente, mas expandidas posteriormente.
  • Para audiências da indústria, enfatize utilidade em engenharia, fluxos de trabalho de P&D, profundidade técnica e capacidades transferíveis.
  • Para audiências acadêmicas, enfatize questões de pesquisa, métodos, publicações e fluxo de apresentação.

Evite adaptar excessivamente a primeira versão. Deixe lugares claros para futuras páginas de apresentação de projetos.

8. Verificar Localmente

Execute:

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

No Windows/PowerShell, prefira npm.cmd se npm estiver bloqueado pela política de execução de scripts.

Se a telemetria do Astro tentar escrever fora do espaço de trabalho, defina scripts em 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"

Verifique:

  • O build é bem-sucedido.
  • As rotas locais retornam 200.
  • Os ativos públicos carregam.
  • Nenhum detalhe sensível é mostrado acidentalmente.
  • A inspeção visual no navegador é realizada quando disponível, ou o usuário revisa manualmente.

9. Atualizar Arquivos de Status e Readme

Atualize um arquivo de status/dashboard se o projeto usar um, por exemplo:

PROJECT_STATUS.md

Arquivos de suporte úteis:

  • readme_website.txt: como editar, visualizar, construir e fazer commit do site.
  • readme_git.txt: configuração do Git e comandos comuns.
  • WEBSITE_WORKFLOW.md: fluxo de trabalho de longo prazo.

Mantenha o status conciso. Não adicione detalhes ruidosos do Git a menos que o usuário peça.

Expectativas de Saída

Ao final de uma primeira passagem, o projeto deve ter:

  • Markdown do CV extraído.
  • Rascunho da estrutura do site.
  • Um site Astro funcional.
  • Conteúdo separado do código de página/layout.
  • Um build bem-sucedido.
  • Uma URL de visualização local.
  • Notas claras sobre o que ainda está pendente.

Individual skills in this repo

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

Habilidades Relacionadas