Communitygithub.com

oraekene/portfólio-de-uma-página

Cria e publica uma página de portfólio de uma página para uma função alvo.

O que é portfólio-de-uma-página?

Esta skill gera uma página de portfólio de uma página para Kenechukwu, destinada a ser um artefato público e linkável para candidaturas, prospecção a frio, perfis sociais ou quando uma função pede amostras de trabalho. Diferente de um CV personalizado (que faz afirmações limitadas), o portfólio mostra evidências reais com links para repositórios, demos, notebooks, publicações e outras provas. A página é estática, versionada por função alvo, e contém: uma linha de posicionamento, 3-5 itens de trabalho selecionados do banco STAR, um resumo de capacidades, links de artefatos anexados a cada item, contato e data da última atualização. A skill suporta variantes por cluster de função alvo e modo de pitch (role-fit, role-creation, service), com um limite de 4-5 variantes para evitar obsolescência. O conteúdo é proposto pela skill e confirmado por Kenechukwu, com verificações de link rot e limites rígidos sobre artefatos que podem ser compartilhados (apenas o que é próprio ou já público com permissão). Não há CMS, temas, análises ou construção de site completo; o foco é gerar um único arquivo HTML editável manualmente.

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

Perguntar na sua IA favorita

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

Documentação

Portfolio One-Pager (Portfólio de Uma Página)

Quando esta skill se aplica

Use quando Kenechukwu quer uma única página pública representando seu trabalho — para um link em uma candidatura, uma assinatura de prospecção 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 eu linko quando pedem amostras de trabalho", "crie um one-pager para a busca de [função]".

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

Isso ficou indeciso em várias revisões, e é a única adição neste pacote que produz um novo entregável voltado ao usuário em vez de melhorar um existente. É exatamente por isso que foi adiado repetidamente, e merece uma resposta declarada em vez de outro adiamento.

A resposta é: construir, de forma restrita.

O caso a favor: tudo o que um one-pager 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 passagem de verificação de alegações, 21-output-templates tem o sistema de estrutura, e 17-cold-prospecting já quer algo para linkar. Não construir significa que Kenechukwu monta manualmente, a partir de um corpus que este pipeline mantém, o único artefato que é mais reutilizável entre candidaturas.

O caso contra, e por que isso define o escopo: um portfólio é um problema de design tanto quanto de conteúdo, e este pipeline não tem nada a ver com ser um construtor de sites. Um "sistema de portfólio" com temas, galerias, análises e um CMS seria um segundo produto vivendo dentro de um pipeline de busca de emprego.

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

Portfólio versus CV personalizado — para que cada um serve

A forma mais comum de errar é construir um portfólio que é um CV mais bonito. Eles fazem trabalhos diferentes, e a diferença não é apresentação.

CV Personalizado (05-resume-customizer)Portfólio One-Pager
Como chega ao leitorEmpurrado. Enviado para um empregador para uma vaga.Puxado. O leitor clica em um link e chega.
O que o leitor já sabeEles têm a descrição da vaga na frente. Sabem com 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 uma função existeSempre.Frequentemente não — que é toda 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 repositório, o sistema rodando, o notebook, o artigo.
Restrições de formatoParsing ATS, uma página, layout convencional, sem formatação criativa.Sem parser. Capturas de tela, diagramas, narrativa mais longa, links.
Modo de falhaPalavras-chave perdidas; não corresponder à descrição da vaga.Links mortos, conteúdo desatualizado ou vazar algo que não deveria ser público.

A linha que importa é "evidência". Todo o resto é consequência disso. Um CV 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 passa nele. Um portfólio é a camada de artefato: o lugar onde "reduziu o tempo de deploy de 40 minutos para 6" se torna um repositório 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 CV com pior compatibilidade ATS e não deveria ser publicado — a passagem de pré-publicação de 09-risk-tactics-gate impõe isso (veja "Links de artefatos" abaixo).

Quando cada um é necessário:

  • CV, sempre. Toda candidatura. Não opcional, e esta skill não reduz isso.
  • Portfólio, quando o leitor chega sem contexto. Prospecção a frio (17-cold-prospecting), um link em uma biografia social, uma função que explicitamente pede 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 CV carrega a URL do portfólio; o portfólio não reproduz o CV. 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 CV vai para um destinatário. Um portfólio é encontrável por qualquer um, incluindo o empregador atual, e publicar um é um ato moderadamente visível. O tratamento de modo de discrição de 16-career-pulse se aplica: se Kenechukwu está procurando silenciosamente, isso é um insumo real para se isso chega a ser publicado, e a skill levanta isso uma vez na primeira publicação em vez de assumir de qualquer forma.

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

Um portfólio sem links é um CV. 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 rodando. Link de maior valor que existe — um leitor pode usar em dez segundos.
repoGitHub/GitLab. Link para a raiz do repositório a menos que um arquivo específico seja o ponto; um link profundo para um arquivo parece cherry-picking.
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 trabalhos 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 uma publicação.

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

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

Link rot é verificado, porque a falha é silenciosa e total. Um portfólio com links mortos é 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 repositório tornado privado, ou um Colab que agora requer permissão são todos reportados por URL — nunca silenciosamente removidos da página, porque um artefato removido silenciosamente significa que a página fica silenciosamente mais fraca e ninguém percebe.

O que é seguro linkar — o limite rígido. Apenas artefatos que Kenechukwu possua 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 de "Kenechukwu pode sobrescrever" — 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, em um nível de abstração que não revela nada, é legítimo e frequentemente mais legível do que o código teria sido.

Seis blocos, em ordem. Cada um é extraído da memória confirmada existente; esta skill não origina fatos (Regra 5).

  1. Linha de posicionamento — uma frase, o que ele faz e para quem. Derivada de target-profile.yaml's título alvo atual e content-model-overlap.md's enquadramento, confirmado por Kenechukwu antes de publicar. 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. Cada número carrega a mesma barra de quantificação que um bullet de currículo. Um portfólio não é uma superfície de menor evidência porque é auto-publicado; se algo, uma alegação permanente em uma página pública merece mais cuidado do que uma em um documento enviado uma vez.
  3. Resumo de capacidades — habilidades agrupadas com a evidência anexada, de domain-knowledge.md. Agrupado, não uma parede de tags.
  4. Links de artefatos por item de trabalho — anexado ao item 2, não listado separadamente no final. Um link ao lado da alegação que evidencia está fazendo trabalho; o mesmo link em um apêndice de "trabalhos selecionados" é uma lista que o leitor pula. Veja "Links de artefatos" acima.
  5. Contato — o que Kenechukwu já escolheu tornar público. Padrão é 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, o que é um argumento para o prompt de atualização abaixo, não contra mostrá-la.

Variantes — dois eixos, não um

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

Eixo 1 — cluster de título alvo (voltado a candidaturas). 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 em um plano de vários saltos: a página deve apresentá-lo para a função para a qual ele está se candidatando agora, não para a que está dois movimentos distante.

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

Modo de pitchPergunta do leitorCom o que a página começa
Role-fit"Ele poderia fazer o trabalho que já temos?"Mesma forma que a variante de candidatura. Frequentemente a mesma variante.
Role-creation"Essa função vale a pena ser criada aqui?"O problema que a função resolve, evidenciado pelo trabalho onde ele o resolveu. A função é o argumento, não o CV.
Service"Eu contrataria essa pessoa para um trabalho definido?"Escopo, entregável e trabalho comparável no passado. Mais próximo de uma página de consultoria — e aquele que um portfólio em forma de função interpreta ativamente mal.

Prospecção role-fit geralmente não precisa de variante separada — reutiliza a correspondente ao título alvo. Apenas pitches de role-creation e service geralmente justificam a sua própria, e apenas se Kenechukwu fizer esse tipo de pitch com frequência suficiente para valer a pena manter.

Relevância por prospecção sem variantes por prospecção. Em vez de uma página por prospecto, a página publicada carrega uma âncora estável por item de trabalho (#credit-scoring-pipeline), e 17-cold-prospecting faz deep-link para o relevante. Uma variante serve muitos prospecções, cada um pousando o leitor no item que motivou o e-mail. Esta é a verdadeira razão para não proliferar variantes: a adaptaçã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 o pior fracasso de um portfólio é estar desatualizado. Se uma sexta for solicitada, a melhor pergunta é geralmente se duas existentes convergiram.

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

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

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

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

  1. O pool elegível — cada entrada STAR, capacidade e artefato já confirmado na memória, cada um com um resumo de uma linha e um id. Construído por varredura; Kenechukwu nunca digita. Este é o menu, e é a resposta para "o que poderia ir em uma página."
  2. Regras globais — always_include para os um ou dois itens principais que pertencem a toda variante independentemente do alvo, e never_include para qualquer coisa que ele não quer público. never sobrepõe tudo, incluindo uma seleção por variante, e é o lar certo para trabalhos que são tecnicamente compartilháveis, mas que ele prefere não destacar.
  3. Seleção por variante — uma lista ordenada de ids. A ordem é significativa e a página renderiza como dada, porque em um one-pager o primeiro item é a maior parte da impressão.

Como a conversa acontece. Em uma nova variante, esta skill propõe uma seleção do pool com uma razão por item, classificada para aquele alvo. Kenechukwu adiciona, remove e reordena em linguagem natural — "remova o segundo, coloque o trabalho de pagamentos no topo, adicione 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 a cada vez. Uma página que Kenechukwu curou não deve se reorganizar silenciosamente porque uma nova entrada STAR chegou.

Novo material é oferecido, nunca inserido. Quando algo entra no banco que seria classificado alto 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 nome dele.

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 Kenechukwu vai querer editá-la manualmente e um arquivo gerado que ele não pode tocar é pior do que nenhum arquivo.

Habilidades Relacionadas