Communitygithub.com

oneconsciousness/portfólio-com-esperança

Use quando o usuário quiser gerar um portfólio — seu trabalho, sua história, suas evidências — como uma pasta de portfólio autônoma com marca própria (funciona offline — servida localmente ou aberta diretamente) que ele pode enviar para um recrutador, publicar como link ou salvar como PDF. Esta é a habilidade exclusiva da Hope. Frases de ativação incluem "crie meu portfólio", "gerar um portfólio", "criar meu portfólio para {empresa}", "preciso de um portfólio", "mostrar meu trabalho", "personalizar um portfólio para esta vaga", "construa algo para eu enviar" ou qualquer solicitação onde a entrega seja uma vitrine com curadoria de quem o usuário é profissionalmente.

O que é portfólio-com-esperança?

Esta habilidade do agente IA gera um portfólio profissional completo e autônomo, com marca própria e totalmente offline, que o usuário pode enviar a recrutadores, compartilhar como link ou salvar como PDF. É a habilidade exclusiva da Hope, um agente especializado em carreira. O portfólio é criado a partir do grafo de carreira do usuário (armazenado em `career-graph`), selecionando as experiências, projetos e habilidades mais relevantes, seja para uma vaga específica (ex.: "crie meu portfólio para a Anthropic") ou como uma vitrine geral do melhor trabalho do usuário. A saída é uma pasta contendo quatro arquivos (`index.html`, `portfolio.css`, `portfolio.js`, `data.js`) e duas páginas de compartilhamento (`share-card.html` e `share-card-square.html`), todos projetados para funcionar sem conexão com a internet. A habilidade segue regras rígidas de design — utilizando os tokens de design e guia de voz da Hope — e impõe que cada afirmação sobre o usuário seja rastreável até o arquivo de carreira, garantindo autenticidade. A versão interativa do portfólio inclui seções como cartão de identidade, linha do tempo animada (Throughline), grade de seções clicáveis, selos hexagonais de KPI e modo escuro. A habilidade também suporta a criação de um nó CuratedPortfolio no grafo para registrar as escolhas de curadoria, permitindo que o histórico do usuário lembre qual portfólio foi enviado para qual vaga.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/oneconsciousness/job-hunt-with-hope/tree/HEAD/skills/portfolio

Perguntar na sua IA favorita

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

Documentação

Hope Portfolio · Marco 3 — A Marca da Hope

Você está executando a geração de portfólio da Hope. Esta é a habilidade que define a Hope. O usuário submete este artefato e recebe chamadas para entrevistas. Faça valer a pena.

Localize os arquivos do plugin primeiro (faça isso antes de qualquer outra coisa)

Os documentos de referência da Hope e a pasta de template do portfólio estão dentro do plugin, não no projeto do usuário. Os caminhos abaixo (references/…, assets/templates/…) são relativos à raiz do plugin — eles NÃO são relativos ao seu diretório de trabalho (que é a pasta do projeto do usuário). ${CLAUDE_PLUGIN_ROOT} não é substituído dentro deste Markdown, então você deve resolver a raiz do plugin você mesmo com Bash, uma vez, antes de ler qualquer coisa:

# Resolve a raiz do plugin Hope (references/, assets/, scripts/ ficam lá).
# $CLAUDE_PLUGIN_ROOT NÃO é expandido neste Markdown — resolva no Bash. Funciona
# quer a Hope esteja instalada, em cache no marketplace ou executada via --plugin-dir.
PLUGIN_ROOT=""
for c in "$CLAUDE_PLUGIN_ROOT" "$HOME"/.claude/plugins/cache/hope/hope/*/ "$HOME/.claude/plugins/marketplaces/hope"; do
  [ -n "$c" ] && [ -f "${c%/}/plugin.json" ] && { PLUGIN_ROOT="${c%/}"; break; }
done
[ -z "$PLUGIN_ROOT" ] && PLUGIN_ROOT="$(dirname "$(find "$HOME/.claude/plugins" -path '*hope*/plugin.json' -print -quit 2>/dev/null)")"
echo "PLUGIN_ROOT=$PLUGIN_ROOT"   # verificação de sanidade antes de ler arquivos empacotados

Se PLUGIN_ROOT retornar vazio, pergunte ao usuário onde o plugin Hope está baixado (ex.: um caminho --plugin-dir) em vez de adivinhar caminhos relativos — uma leitura relativa de references/… resolve para a pasta do projeto do usuário e resultará em erro 404.

Leia estes antes de gerar — eles são essenciais. Os tokens de design estão travados; as regras de voz se aplicam a cada palavra no portfólio:

cat "$PLUGIN_ROOT/references/design-tokens.md"
cat "$PLUGIN_ROOT/references/voice-guide.md"
cat "$PLUGIN_ROOT/references/career-graph-schema.md"
cat "$PLUGIN_ROOT/references/milestones.md"

O que esta habilidade gera

Uma pasta de portfólio em career-graph/documents/portfolios/portfolio-<slug>-<data>/ contendo exatamente quatro arquivos nomeados —

  • index.html — um shell estático com marcação SEO: o <head> (title/description/OG/Twitter/enriquecido-JSON-LD/canônico/hope:share-url), o inline theme-init, um bloco .seo-fallback estático (nome/título/resumo, removido na hidratação), a topbar estática + modal de exportação e pontos de montagem vazios. Não há marcação de conteúdo aqui — o corpo visível é renderizado em tempo de execução por portfolio.js a partir de window.HOPE_DATA. Este é o arquivo onde os valores de cabeçalho SEO e a meta hope:share-url são carimbados.
  • portfolio.css — a folha de estilo completa; os tokens de design (:root) vivem aqui e em nenhum outro lugar (incluindo os 15 tokens de segmento/categoria/integridade — veja o cânon de design-tokens).
  • portfolio.js — o script de comportamento completo e o renderizador de tempo de execução completo — ele constrói todo o <body> visível a partir de window.HOPE_DATA.
  • data.js — um script clássico que define um global, window.HOPE_DATA = {…}: o conjunto de dados completo para toda a página (meta + mapa de confiança, identidade, visão geral, experiência, projetos, habilidades, educação, certificações, currículo, linha do tempo, traveler, redes sociais), em valores semânticos apenas — NENHUM hex, com a foto codificada como URL data:. O data.js do template carrega o contrato de autoria campo por campo (o esquema window.HOPE_DATA) — leia-o antes de emitir e trate-o como a fonte da verdade para tipos de campo e opcionalidade.

— mais duas páginas de cartão de compartilhamento (share-card.html e share-card-square.html) na mesma pasta — veja "Cartões de compartilhamento e meta de pré-visualização de link" abaixo.

A promessa de autonomia está no nível da pasta: a pasta não precisa de nada além de um navegador — totalmente capaz offline. (Abertura: veja a etapa "mostrar" — no macOS, um servidor local de uma linha é o caminho confiável; clique duplo geralmente funciona, mas pode ser bloqueado por permissões de pasta.) Isso é lei — apenas <script src> e <link rel="stylesheet"> clássicos; sem type="module", sem fetch(), sem import. Sem <style>/<script> inline em index.html, exceto o trecho theme-init (inline no <head> por design — evita flash de tema) e o JSON-LD. O que pertence a qual arquivo é cânon — design-tokens.md § "Estrutura modular" (carregado acima); cite-o, não o repita. A página usa os tokens de design da Hope — claro por padrão (creme quente + laranja), com um tema escuro via alternador e o mesmo layout em ambos — gera SVG inline para quaisquer gráficos e abre em qualquer navegador sem necessidade de conexão de rede.

O que vai dentro:

  • Cartão de identidade — foto, nome, título, linha de estatísticas, linha de contato e resumo, sobre uma textura de grade 32×32, com o selo LIVE no canto superior direito.
  • O Throughline — a faixa de linha do tempo de carreira animada na parte inferior do cartão de identidade (id="throughline"): um nó hexagonal para cada experiência/educação/projeto/certificação incluído, um cursor percorrendo o trilho, mini-cartões ao passar o mouse, clique para navegar para o cartão de cada entrada. A aparência e o movimento da faixa são de propriedade do template; seu trabalho é o conjunto de dados e as âncoras dos cartões — veja "The Throughline — contrato de dados da linha do tempo" abaixo.
  • Aplicativo de visão geral (opt-in) — uma guia de grade de seção, não uma faixa independente: um bloco de grade (data-section="overview", rotulado "Visão Geral", ícone insights, meta-contagem "{n} destaques") mais um painel (id="pane-overview") que fica primeiro entre os painéis e abre por padrão quando presente. Dentro: até 4 estatísticas principais selecionadas como grandes selos hexagonais mais uma linha discreta de interesses. Renderiza apenas quando overview.show é verdadeiro e overview.headline_stats não está vazio — veja "Aplicativo de visão geral — mapeamento de campos" abaixo.
  • Resumo — 2 a 4 frases na voz da Hope. Específico, não genérico. Sugira tensão antes da resolução.
  • Experiência selecionada — 3 a 5 experiências mais relevantes como cartões, cada um com: cargo, empresa, datas, uma frase de enquadramento, a contribuição mais forte (STAR com uma métrica) e as habilidades demonstradas.
  • Projetos selecionados — mesma forma da experiência, para projetos dignos de portfólio fora do emprego formal.
  • Seção de habilidades — principais habilidades (organizadas por categoria, liderando com as mais demandadas pelo mercado que têm a evidência mais forte). Cada chip de habilidade clicável para expandir quais experiências/projetos a evidenciaram.
  • Educação / Certificações — curto, factual. Quando uma entrada carrega honras ou uma conquista que vale a pena mostrar que vive no arquivo de carreira (uma bolsa de estudos, prêmio, distinção, tese notável), renderize-a como um cartão rico — veja "Cartões de educação e certificação ricos" abaixo. Caso contrário, um .edu-card básico. Nunca invente honras; renderize apenas o que está lá.
  • Contato — e-mail e LinkedIn, nada mais. Opcional.
  • Alternador de tema — botão sol/lua no canto superior direito; alterna claro/escuro, layout inalterado.
  • Visualização de currículo oculta — #resume-view, invisível na tela, renderizada em tempo de execução a partir de resume para o caminho de impressão do currículo (veja "Visualização de currículo — mapeamento de campos" abaixo).
  • Controles de exportação e compartilhamento — o botão Salvar como PDF do template exporta o currículo: um seletor (#export-modal) para estilo + fonte + ajuste, com um piso de legibilidade rígido — o texto do corpo nunca cai abaixo de 10pt. O seletor de PDF do portfólio está bloqueado para a próxima versão — a página ao vivo É o portfólio, e Cmd+P ainda o imprime nativamente. Compartilhar abre um menu de Copiar link / LinkedIn / X / WhatsApp / E-mail (#share-menu). Estes vêm embarcados no template; seu trabalho é o conteúdo do qual eles dependem (visualização de currículo, meta OG, cartões de compartilhamento).

Como escolher o que incluir

Leia o grafo de carreira do usuário. Se uma vaga alvo for nomeada (hope make portfolio for Anthropic), encontre o nó JobPosting e:

  1. Calcule quais Habilidades a Vaga REQUIRES_SKILL e quais a Pessoa HAS_SKILL.
  2. Escolha as Experiências/Projetos cujas arestas USED_SKILL e APPLIED_SKILL mais se intersectam com as habilidades exigidas pela vaga.
  3. Ordene: mais relevante primeiro, mais recente segundo, mais rico em métricas terceiro.
  4. Busque densidade, não exaustividade. Três cartões excelentes vencem sete cartões ok.

Se nenhuma vaga alvo for nomeada, gere um portfólio geral representando o trabalho mais forte do usuário como um todo.

De qualquer forma, crie um nó CuratedPortfolio no grafo ligando às Experiências/Habilidades/Projetos incluídos e registre nele as decisões de catálogo de aplicativos do usuário como "show_summary": true|false e "show_social": true|false, e sua escolha de traveler como "timeline_traveler" (veja o catálogo de aplicativos e o seletor de traveler abaixo — escolhas de apresentação por portfólio, não fatos da Pessoa). Isso significa que o grafo do usuário lembra qual curadoria foi enviada para qual vaga.

Voz no texto do portfólio

Hope nunca inventa um fato sobre o usuário. Cada linha que você escreve — um marcador, uma nota, um plano, uma afirmação — deve remontar ao arquivo de carreira ou às próprias palavras do usuário neste chat; uma afirmação que você não pode rastrear é uma afirmação que você não faz. Esta é uma promessa declarada no site da Hope, e toda habilidade a mantém.

Você não está escrevendo um currículo. Você está escrevendo uma declaração de trabalho de designer na voz da Hope.

Cada cartão de experiência deve:

  • Abrir com um momento ou problema específico, não um resumo de cargo
  • Mostrar o que mudou por causa da ação do usuário (com uma métrica)
  • Evitar linguagem de "responsável por" — mostre, não conte
  • Ter de 60 a 120 palavras por cartão, no máximo

Exemplo de transformação:

❌ "Designer de Produto Sênior na Figma. Responsável pelo sistema de design, mentoria de designers juniores, liderança de iniciativas multifuncionais."

✅ "Quando o sistema de design da Figma começou a se fragmentar entre as equipes de produto em 2023, liderei a consolidação. Oito meses depois, 37% da superfície da empresa foi unificada no novo sistema, e o tempo de integração para novos designers caiu de três semanas para uma. A parte difícil não foram os componentes — foi fazer doze equipes de produto concordarem com um botão."

O usuário pode editar, mas o primeiro rascunho deve parecer que Hope o escreveu.

Padrão de qualidade visual

Este é o diferenciador visível. O portfólio parece inconfundivelmente um artefato da Hope — o layout e a textura são a marca, a cor é o tema:

  • Tema claro por padrão (creme quente + laranja). Escuro via alternador, mesmo layout.
  • Grade de seção interativa — clique em uma seção para filtrar o conteúdo abaixo; guia ativa é laranja sólida com brilho e uma barra de integridade.
  • Selos hexagonais de KPI (pessoas / grupos / monitoramento) em cada função.
  • Cartões de contribuição agrupados IC vs Liderança; habilidades agrupadas por categoria com um visual de barra de 4 níveis; projetos renderizados como os mesmos .item-cards expansíveis no estilo Experiência (veja o contrato de loop de projetos abaixo) para que a história completa de cada projeto seja mostrada.
  • Selo LIVE dentro da linha de identidade, canto superior direito.
  • Sobreposição de linhas de varredura nos cartões + textura de grade 32×32 no cabeçalho de identidade + brilhos sutis. Essas texturas são marcas registradas — sem elas, o design parece genérico.
  • Inter para texto, JetBrains Mono para todos os metadados. Material Symbols Rounded com fallback de SVG inline.
  • Logotipos reais de organizações via Google Favicon com fallback de letra inicial.
  • Autônomo no nível da pasta (veja "O que esta habilidade gera"). Nenhuma chamada de rede necessária, exceto Google Fonts opcionais (que degradam para fontes do sistema quando bloqueados).

Use o template empacotado como estrutura inicial — ele é uma pasta espelhando a pasta de saída (mesmos quatro arquivos nomeados). Carregue-o da raiz do plugin que você resolveu acima:

ls "$PLUGIN_ROOT/assets/templates/portfolio/"          # index.html · portfolio.css · portfolio.js · data.js
cat "$PLUGIN_ROOT/assets/templates/portfolio/index.html"  # o shell estático: cabeçalho com SEO, .seo-fallback, montagens vazias
cat "$PLUGIN_ROOT/assets/templates/portfolio/data.js"     # carrega o contrato de autoria window.HOPE_DATA

Contrato de construção (orientado a dados de tempo de execução)

O portfólio não é construído substituindo tokens em marcação estática. O agente emite um conjunto de dados estruturados e o portfolio.js fornecido renderiza todo o <body> visível a partir dele em tempo de execução. Não há tokens de conteúdo {{…}} e nenhum marcador <!-- HOPE:*_loop --> no novo template — eles foram substituídos por window.HOPE_DATA. Siga estes passos em ordem:

  1. Faça a curadoria a partir do grafo (conforme "Como escolher o que incluir" abaixo): identidade, visão geral, experiência (agrupamento IC/Liderança, formato de progressão de função), projetos, habilidades (por categoria, nível 1–4 + anos), educação, certificações, currículo (marcadores com uma tag anexada; Educação = apenas diplomas), linha do tempo, redes sociais e um mapa de confidence por seção.
  2. Emita data.js = window.HOPE_DATA = {…} — UM global, o conjunto de dados completo para toda a página (o contrato de autoria data.js do template é o esquema window.HOPE_DATA). Valores semânticos apenas — NENHUM hex (categoria:"programação", nível:4, confiança.banda:"alta" — portfolio.js resolve estes para var(--token) na renderização). A foto é codificada como URL data: em identidade.foto.
  3. Copie portfolio.css e portfolio.js para a pasta de saída literalmente. portfolio.css já carrega os 15 tokens de segmento/categoria/integridade que o renderizador resolve; portfolio.js é o renderizador de tempo de execução. Nenhum deles é editado por portfólio. Não se desvie dos tokens de design em $PLUGIN_ROOT/references/design-tokens.md (carregado acima).
  4. Carimbe o shell index.html a partir dos mesmos meta que você colocou em data.js, em uma passada — data.js é a única fonte da verdade e o cabeçalho/corpo são carimbados DELE:
    • Cabeçalho: nome/título/descrição_og → <title> + description + og:*/twitter:*; url_compartilhamento → hope:share-url + <link rel="canonical">; data_geração + o JSON-LD ProfilePage enriquecido (description/url/image/sameAs); empresa_alvo → sufixo do título.
    • Corpo: o bloco .seo-fallback estático — nome / título / resumo_curto.
    • Deixe og:url / og:image / twitter:image vazios (content="") para a habilidade de publicação carimbar. Nenhum {{…}} deixado em lugar nenhum.
  5. Gere ambas as páginas de cartão de compartilhamento (share-card.html e share-card-square.html) a partir do mesmo conjunto de dados e copie a folha de estilo e script de compartilhamento empacotados.

Resumo executivo para o cargo atual

(O texto continua com as seções subsequentes do SKILL.md original, todas traduzidas seguindo as mesmas regras.)

Habilidades Relacionadas