Communitygithub.com

oraekene/hermes-portfolio-empregos

Construa e publique uma página de portfólio de uma página para uma função-alvo.

O que é hermes-portfolio-empregos?

Esta skill auxilia na criação de uma página de portfólio única e focada para candidaturas a vagas específicas. Ela gera conteúdo a partir de um banco de memórias confirmadas (regra 5), evitando a criação de fatos novos. A skill implementa uma decisão de design deliberadamente restrita: não é um construtor de sites completo, mas gera uma página estática versionada por função-alvo, sem CMS, temas ou analytics. O valor central está nos links para artefatos reais (repositórios, demos, notebooks, writeups) que validam as afirmações do currículo. A página é organizada em seis blocos: linha de posicionamento, três a cinco itens de trabalho do banco STAR, resumo de capacidades, links de artefatos por item, contato e data da última atualização. A skill oferece suporte a múltiplos variantes ao longo de dois eixos: cluster de cargo-alvo (para aplicações) e modo de abordagem (para prospecção outreach). O usuário seleciona e ajusta o conteúdo proposto via `shared/portfolio-manifest.yaml`. A publicação gera HTML estático sem dependências de build. A skill verifica a integridade dos links e a segurança dos artefatos, com uma barreira rígida contra links não autorizados. Uma atualização trimestral verifica o frescor dos links e sugere novos conteúdos relevantes. A skill é compatível com plataformas como Claude Code, Cursor, Codex e outras ferramentas de IA para engenharia de software.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/oraekene/hermes-jobhunting/tree/HEAD/23-portfolio-onepager

Perguntar na sua IA favorita

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

Documentação

Portfólio de Uma Página

Quando esta skill se aplica

Use quando Kene quiser uma única página pública representando seu trabalho — para um link em uma candidatura, uma assinatura de contato a frio, um perfil social, ou porque uma função pede explicitamente um portfólio. Gatilhos: "Preciso de uma página de portfólio", "o que colocar como link quando pedem amostras de trabalho", "crie uma página para a busca de [função]."

A decisão que esta skill registra (A26/A27)

Ficou indecisa por várias revisões, e é a única adição a este pacote que produz uma entrega voltada ao usuário em vez de melhorar uma existente. É exatamente por isso que foi adiada, e merece uma resposta declarada em vez de mais um adiamento.

A resposta é: construir, mas de forma restrita.

A favor: tudo que uma página única precisa já está no pacote e já confirmado sob a Regra 5. O banco STAR tem as histórias, o portão de quantificação tem os números, 09-risk-tactics-gate tem a verificação de afirmações, 21-output-templates tem o sistema de estrutura, e 17-cold-prospecting já quer algo para linkar. Não construir significa que Kene montará manualmente, a partir de um corpus que este pipeline mantém, o artefato mais reutilizável entre candidaturas.

Contra, e que define o escopo: um portfólio é um problema de design tanto quanto de conteúdo, e este pipeline não tem a ver com ser um construtor de sites. Um "sistema de portfólio" com temas, galerias, analytics e um CMS seria um segundo produto dentro de um pipeline de busca de emprego.

Então o escopo é deliberadamente restrito: uma página, gerada a partir de memórias confirmadas, publicada como HTML estático, versionada por função-alvo. Sem CMS, sem site multi-página, sem sistema de temas, sem analytics de visitantes. Se Kene quiser um site pessoal real, isso gera um bom arquivo inicial e ele leva para outro lugar — e esta skill deve dizer isso claramente, em vez de crescer nessa direção.

Portfólio versus currículo personalizado — para que cada um serve

A maneira mais comum de fazer isso errado é construir um portfólio que é um currículo mais bonito. Eles têm funções diferentes, e a diferença não é de apresentação.

Currículo Personalizado (05-resume-customizer)Portfólio de Uma Página
Como chega ao leitorEmpurrado. Enviado a um empregador para uma vaga.Puxado. O leitor clica num link e chega.
O que o leitor já sabeEles têm a descrição da vaga na frente. Sabem contra o que estão comparando.Frequentemente nada. Pode ser um recrutador navegando, um gerente de contratação que recebeu um e-mail frio, alguém de uma conferência, uma pessoa que acabou de ler uma resposta dele no X.
Se existe uma vagaSempre.Frequentemente não — que é a base da prospecção a frio.
Vida útilCongelado no envio. Um instantâneo.Vivo. Mutável e permanentemente público.
EvidênciaAfirma. "Reduziu o tempo de deploy de 40 minutos para 6."Mostra. Aqui está o repo, a coisa funcionando, o notebook, o texto.
Restrições de formatoParsing ATS, uma página, layout convencional, sem formatação elaborada.Sem parser. Capturas de tela, diagramas, narrativa mais longa, links.
Modo de falhaPalavras-chave perdidas; não corresponder à descrição da vaga.Links quebrados, conteúdo desatualizado ou vazamento de algo que não deveria ser público.

A linha que importa é "evidência". Todo o resto é consequência disso. Um currículo só pode fazer afirmações — o formato não tem espaço para provas e o leitor não tem como verificar nos noventa segundos que gasta nele. Um portfólio é a camada de artefato: o lugar onde "reduziu o tempo de deploy de 40 minutos para 6" se torna um repo com a configuração de CI antes e depois no histórico.

Essa é a razão para construir um. Se uma página de portfólio não carrega links para artefatos reais, é um currículo com pior compatibilidade com ATS e não deve ser publicada — a passagem de pré-publicação de 09-risk-tactics-gate aplica isso (veja "Links de artefatos" abaixo).

Quando cada um é necessário:

  • Currículo, sempre. Toda candidatura. Não opcional, e esta skill não reduz isso.
  • Portfólio, quando o leitor chega sem contexto. Contato a frio (17-cold-prospecting), um link numa bio social, uma função que pede explicitamente amostras de trabalho, uma indicação onde alguém está passando o nome dele, ou qualquer conversa onde "o que você construiu" vem antes de "aqui está a descrição da vaga."
  • Ambos, linkados. O currículo carrega a URL do portfólio; o portfólio não reproduz o currículo. Redundância entre eles é espaço desperdiçado na página e uma segunda coisa para manter sincronizada.

A consideração do empregador atual. Um currículo vai para um destinatário. Um portfólio é encontrável por qualquer um, incluindo um empregador atual, e publicar um é um ato levemente visível. O modo de discrição de 16-career-pulse se aplica: se Kene está pesquisando quietamente, isso é uma entrada real sobre se isso será publicado, e a skill levanta uma vez na primeira publicação, em vez de assumir de um jeito ou de outro.

Links de artefatos — o conteúdo principal, não um rodapé

Um portfólio sem links é um currículo. Links são para o que ele serve, então recebem tratamento de primeira classe, em vez de uma lista de "trabalhos selecionados" no final.

Cada item de trabalho pode carregar um ou mais artefatos:

TipoNotas
deployedA coisa funcionando. Link de maior valor que existe — um leitor pode usar em dez segundos.
repoGitHub/GitLab. Link para a raiz do repo a menos que um arquivo específico seja o ponto; um link profundo para um arquivo parece escolha a dedo.
notebookColab, Jupyter, Kaggle. Veja a nota de legibilidade abaixo.
writeupUm post de blog, um documento de design, um postmortem. Frequentemente o artefato mais forte para trabalho cujo código não é compartilhável.
demoUma gravação de tela onde a coisa não pode ser implantada publicamente. Dois minutos, sem narração necessária.
packagenpm, PyPI, crates.io — uma coisa publicada e instalável.
paperarXiv ou um evento publicado.

Notebooks precisam de uma verificação de legibilidade que repos não precisam. Um .ipynb com saídas limpas é uma parede de código que não prova nada para alguém passando os olhos. Link para a forma renderizada — um link Colab que funciona, ou nbviewer / renderização do próprio GitHub com saídas commitadas — e certifique-se de que a célula superior diz para que serve o notebook. Um notebook cuja primeira coisa visível é import pandas as pd é um link que o leitor fecha.

Um repo precisa de um README que sobreviva trinta segundos. Se o README do repo não diz o que a coisa é e por que existe, linká-lo é pior do que não linkar. Esta skill sinaliza isso; não corrige, porque corrigir é trabalho real que Kene tem que fazer.

Rot de link é verificado, porque a falha é silenciosa e total. Um portfólio com links quebrados é pior do que um sem links: parece descuidado exatamente na dimensão que a página existe para demonstrar. Cada URL de artefato é verificado na publicação e re-verificado na atualização trimestral (shared/applications_db_schema_addendum_18.sql, portfolio_artifacts). Um 404, um repo que se tornou privado, ou um Colab que agora requer permissão são todos reportados por URL — nunca removidos silenciosamente da página, porque um artefato removido silenciosamente significa que a página fica mais fraca sem ninguém notar.

O que é seguro linkar — o limite rígido. Apenas artefatos que Kene possui ou que já são públicos com permissão. Código de propriedade do empregador, documentos internos, qualquer coisa sob NDA, e qualquer coisa contendo dados de terceiros não vão para uma página pública. Isso é verificado no momento da adição e novamente na publicação, e é a única verificação nesta skill que não tem um caminho "Kene pode substituir" — o modo de falha é publicar algo que ele não possuía, e isso acaba com carreiras, não com empregos.

Onde o trabalho subjacente não pode ser mostrado, os tipos writeup e demo existem precisamente para isso: descrever um sistema que ele construiu, num nível de abstração que não revela nada, é legítimo e frequentemente mais legível do que o código seria.

Estrutura do conteúdo da página

Seis blocos, em ordem. Cada um é extraído de memórias confirmadas existentes; esta skill não origina fatos (Regra 5).

  1. Linha de posicionamento — uma frase, o que ele faz e para quem. Derivada do target-profile.yaml do título alvo atual e do framing de content-model-overlap.md, confirmada por Kene antes de ser publicada. Esta é a linha mais difícil da página e a que vale mais iteração.
  2. Três a cinco itens de trabalho — do banco STAR, selecionados para a função-alvo da mesma forma que 05-resume-customizer seleciona. Cada um é situação → o que ele fez → o número. Todo número carrega a mesma barra de quantificação de um bullet de currículo. Um portfólio não é uma superfície de evidência inferior porque é autopublicado; se algo, uma afirmação permanentemente numa página pública merece mais cuidado do que uma num documento enviado uma vez.
  3. Resumo de capacidades — habilidades agrupadas com a evidência anexada, de domain-knowledge.md. Agrupadas, não uma parede de tags.
  4. Links de artefatos por item de trabalho — anexados ao item 2, não listados separadamente no final. Um link ao lado da afirmação que ele evidencia está fazendo trabalho; o mesmo link num apêndice de "trabalho selecionado" é uma lista que o leitor pula. Veja "Links de artefatos" acima.
  5. Contato — o que Kene já escolheu tornar público. Padrão para nada até que ele diga o contrário.
  6. Última atualização — uma data real. Um portfólio com uma data desatualizada parece pior do que um sem data, que é um argumento para o prompt de atualização abaixo, em vez de contra mostrá-la.

Variantes — dois eixos, não um

A primeira versão desta skill dizia "uma variante por cluster de título-alvo." Isso está certo para candidaturas e errado para contato a frio, que é uma situação diferente com um leitor diferente.

Eixo 1 — cluster de título-alvo (voltado para candidatura). Mesmo material subjacente, seleção e ordenação diferentes por família de função. O mesmo princípio de um currículo adaptado. O salto atual de 19-career-path-planner é o padrão num plano multi-salto: a página deve apresentá-lo para a função para a qual está se candidatando agora, não para a que está a dois passos de distância.

Eixo 2 — modo de abordagem (voltado para contato). 17-cold-prospecting tem três modos e eles precisam de páginas genuinamente diferentes, porque a pergunta do leitor difere:

Modo de abordagemPergunta do leitorCom o que a página lidera
Adequação à função"Ele poderia fazer o trabalho que já temos?"Mesma forma que a variante de candidatura. Frequentemente a mesma variante.
Criação de função"Vale a pena criar esta função aqui?"O problema que a função resolve, evidenciado por trabalho onde ele o resolveu. A função é o argumento, não o currículo.
Serviço"Eu contrataria esta pessoa para um trabalho definido?"Escopo, entrega e trabalho passado comparável. Mais próximo de uma página de consultoria — e a que um portfólio em forma de função lê ativamente de forma errada.

Contato a frio de adequação à função geralmente não precisa de variante separada — reutiliza a variante de título-alvo correspondente. Apenas abordagens de criação de função e serviço geralmente justificam sua própria, e apenas se Kene faz abordagens assim com frequência suficiente para valer a pena manter.

Relevância por contato sem variantes por contato. Em vez de uma página por prospecto, a página publicada carrega uma âncora estável por item de trabalho (#pipeline-de-credit-scoring), e 17-cold-prospecting linka profundamente para o relevante. Uma variante serve muitos contatos, cada um levando o leitor ao item que motivou o e-mail. Esta é a verdadeira razão para não proliferar variantes: a personalização que importa é qual item eles veem primeiro, e uma âncora faz isso de graça.

Limite. Quatro ou cinco variantes em ambos os eixos é muito. Cada uma é uma página que pode ficar desatualizada independentemente, e a pior falha de um portfólio é estar desatualizado. Se uma sexta for solicitada, a melhor pergunta é geralmente se duas existentes convergiram.

Variantes vivem em shared/portfolio/{slug_da_variante}/, cada uma registrando para que foi construída, o que selecionou e quando.

Escolhendo o que vai para a página — Kene escolhe

Esta skill propõe e ele ajusta. Mesmo formato propor-confirmar-salvar de tudo aqui, não uma página que ele descobre depois.

shared/portfolio-manifest.yaml contém três coisas:

  1. O pool elegível — toda entrada STAR, capacidade e artefato já confirmados na memória, cada um com um resumo de uma linha e um ID. Construído por varredura; Kene nunca digita. Este é o menu, e é a resposta para "o que poderia ir numa página."
  2. Regras globais — always_include para um ou dois itens emblemáticos que pertencem a toda variante independentemente do alvo, e never_include para qualquer coisa que ele não queira público. never vence sobre tudo, incluindo uma seleção por variante, e é o lar certo para trabalho que é tecnicamente compartilhável, mas com o qual ele prefere não liderar.
  3. Seleção por variante — uma lista ordenada de IDs. Ordem é significativa e a página renderiza conforme dada, porque numa página única o primeiro item é a maior parte da impressão.

Como a conversa acontece. Numa nova variante, esta skill propõe uma seleção do pool com uma razão por item, classificado para aquele alvo. Kene adiciona, remove e reordena em linguagem natural — "remove o segundo, coloca o trabalho de pagamentos no topo, adiciona a coisa que fiz para a cooperativa." Confirmado uma vez, escrito no manifesto.

Uma reconstrução nunca re-seleciona silenciosamente. A seleção existente é o ponto de partida toda vez. Uma página que Kene selecionou não deve se reorganizar silenciosamente porque uma nova entrada STAR chegou.

Novo material é oferecido, nunca inserido. Quando algo entra no banco que se classificaria bem para uma variante existente, a atualização trimestral levanta uma vez — "isso seria um bom ajuste para a variante fintech, adicionar?" Uma pergunta, não um diff aplicado em seu nome.

Publicação

HTML estático, um arquivo mais ativos, sem etapa de build e sem framework. A saída é legível e editável manualmente, porque Kene vai querer editá-la manualmente e um arquivo gerado que ele não pode tocar é pior do que nenhum arquivo.

Onde a hospedagem é perguntada e o que acontece se ele não se importa

Na primeira publicação, uma vez. Não na geração…

Habilidades Relacionadas