yashrajnayak/developer-portfolio-skill

Skill de Portfólio para Desenvolvedor

Política Principal

Use o PDF/exportação do LinkedIn enviado pelo usuário ou o texto colado do perfil como fonte da verdade. Não faça scraping do LinkedIn nem contorne a autenticação do LinkedIn. Se o usuário fornecer apenas uma URL do LinkedIn, peça para ele enviar o PDF/exportação do perfil ou colar o texto do perfil.

Antes de qualquer escrita no GitHub, verifique gh auth status e informe ao usuário se for necessário gh auth login. Prefira um rascunho revisável antes de publicar, a menos que o usuário peça explicitamente por publicação automática.

Resolva caminhos relativos de scripts e referências em relação ao diretório deste skill. Não copie caminhos absolutos do sistema de arquivos local para arquivos README gerados, configuração de portfólio ou commits no GitHub.

Fluxo de Trabalho

1. Coletar entradas

   • Caminho do PDF/exportação do LinkedIn, ou texto colado do LinkedIn.
   • Nome de usuário do GitHub, ou obtê-lo de gh api user --jq .login se autenticado.
   • Nomes de repositórios alvo opcionais. Padrões:
     • Portfólio: <github-username>.github.io
     • README do perfil: <github-username>
   • Fonte do modelo de portfólio opcional. Padrão: https://github.com/yashrajnayak/developer-portfolio.

2. Extrair texto do perfil

   • Para PDFs, execute:

     python scripts/extract_linkedin_pdf.py \
       --input <linkedin.pdf> \
       --out <workspace>/linkedin-profile.txt
     

   • Para texto colado, salve-o como linkedin-profile.txt.

3. Normalizar dados do perfil

   • Leia references/profile-schema.md.
   • Converta linkedin-profile.txt em normalized-profile.json.
   • Mantenha as afirmações fiéis à fonte. Não invente empregadores, datas, diplomas, certificações ou métricas.
   • Se o nome de usuário do GitHub for conhecido, inclua github_username.
   • Se uma URL base do portfólio for conhecida, inclua portfolio_url.

4. Gerar configuração do portfólio

   • Execute:

     python scripts/write_portfolio_config.py \
       --profile normalized-profile.json \
       --out config.json \
       --github-username <github-username> \
       --portfolio-url https://<github-username>.github.io
     

   • Copie o config.json gerado para um repositório clonado/fork do modelo developer-portfolio.
   • Execute os comandos de validação/build do repositório modelo, se disponíveis:

     npm run validate
     npm run build
     

5. Gerar README do perfil

   • Execute:

     python scripts/write_profile_readme.py \
       --profile normalized-profile.json \
       --out README.md
     

   • Esta saída é para o repositório de perfil do GitHub <github-username>/<github-username>.

6. Publicar com GitHub CLI

   • Leia references/github-publish.md.
   • Verifique autenticação:

     gh auth status
     gh api user --jq .login
     

   • Antes de enviar, verifique a existência de caminhos locais nos arquivos gerados do portfólio. Se o repositório modelo tiver npm run validate, use-o.
   • Faça commit de forma intencional. Não use force-push. Não sobrescreva repositórios existentes do usuário sem inspecionar o conteúdo atual.

Expectativas de Saída

Retorne:

• PDF/texto fonte utilizado.
• Caminhos gerados: normalized-profile.json, config.json do portfólio e README.md do perfil.
• Repositórios alvo no GitHub.
• Comandos de validação executados.
• Se os pushes para o GitHub foram concluídos ou bloqueados por falta de autenticação/revisão.

Referências

• references/profile-schema.md: contrato JSON do perfil normalizado e regras de mapeamento.
• references/github-publish.md: fluxo seguro de publicação com GitHub CLI.