Communitygithub.com

Upskill

Analisa vagas de emprego monitoradas em relação ao perfil do candidato para encontrar lacunas de habilidades, gerando um mapa de calor priorizado e um plano de estudos com recursos de aprendizado pesquisados e ordem de estudo.

O que é Upskill?

O Upskill é uma skill para agentes de IA (como Claude Code, Cursor ou Codex) que automatiza a identificação de lacunas de habilidades entre o perfil do candidato e os requisitos das vagas de emprego que ele está acompanhando. A skill opera em dois modos: agregado (analisa todas as vagas no arquivo de rastreamento) e direcionado (analisa uma única vaga a partir de uma URL). Ela realiza duas passagens de análise: a primeira identifica lacunas de habilidades técnicas com base em palavras-chave das vagas ou inferências a partir do cargo e setor; a segunda sintetiza lacunas não óbvias, como conhecimento de domínio, habilidades interpessoais, ferramentas e certificações. O resultado é um mapa de calor priorizado (Crítico, Alto, Médio, Baixo) e um plano de estudos detalhado, com recursos de aprendizado pesquisados na web, ordem de estudo sugerida e estimativas de tempo. A skill suporta Claude Code, Cursor e Codex, e é invocada pelos comandos `/upskill` (modo agregado) ou `/upskill <URL>` (modo direcionado). É especialmente útil para profissionais de tecnologia que desejam direcionar seus estudos de forma estratégica com base nas demandas reais do mercado de trabalho.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SongGithub/personal-skills/tree/HEAD/job-search/skills/upskill

Perguntar na sua IA favorita

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

Documentação

O que Upskill faz?

Analisa vagas de emprego monitoradas em relação ao perfil atual do candidato para encontrar lacunas de habilidades, gerando um mapa de calor de lacunas e um plano de estudos com recursos de aprendizado concretos, pesquisados, e uma ordem de estudo.

Configuração

  • Perfil do candidato: $JOB_SEARCH_HOME/profile.md
  • Vagas monitoradas: tracker_path de $JOB_SEARCH_HOME/integrations.yaml
  • Os relatórios são salvos em $JOB_SEARCH_HOME/upskill/

Invocação

  • /upskill — modo agregado: todas as linhas do arquivo de rastreamento
  • /upskill <URL> — modo direcionado: uma vaga, obtida a partir da URL

Passo 1 — Detectar modo

Sem argumento → agregado. Uma URL → direcionado; mantenha a URL para o Passo 2.

No modo direcionado, derive um slug de relatório a partir do cargo e da empresa, ex. <slug-da-empresa>-<slug-do-cargo>.

Passo 2 — Carregar dados

Agregado

  1. Leia o arquivo de rastreamento. Colunas: data, empresa, setor, cargo, tipo_cargo, canal, status, contato, avaliacao_adequacao, notas, arquivo_cv, arquivo_carta_apresentacao, origem
  2. Anote cargo, empresa, avaliacao_adequacao por linha. avaliacao_adequacao é 0–100; use-a para ponderar lacunas, pois uma baixa avaliação significa que a vaga expôs mais lacunas.
  3. Leia $JOB_SEARCH_HOME/profile.md para obter as habilidades atuais.
  4. Verifique em $JOB_SEARCH_HOME/upskill/ o relatório mais recente relatorio-YYYY-MM-DD.md; se houver um, carregue-o para a diffs do Passo 8.

Direcionado

  1. Busque a vaga na web (WebFetch).
  2. Extraia título, empresa, habilidades obrigatórias, habilidades desejáveis, responsabilidades, contexto do domínio.
  3. Leia $JOB_SEARCH_HOME/profile.md.
  4. Nenhum dado do rastreador é usado.

Passo 3 — Passo 1: diff de habilidades técnicas

Agregado. Você não tem as descrições completas das vagas, portanto infira os requisitos prováveis a partir de cargo, setor e notas. Se origem tiver uma URL ativa, você pode buscá-la; pule URLs mortas ou ausentes.

Construa um mapa de frequência de habilidades e pondere pela adequação: cada vaga contribui (100 - avaliacao_adequacao) / 100 por ocorrência. A pontuação final é a soma de peso_adequacao × ocorrencia entre todas as vagas.

Direcionado. Considere as habilidades obrigatórias e desejáveis explícitas. Peso igual. Obrigatórias antes de Desejáveis, em ordem alfabética dentro de cada grupo.

Comparar com o perfil. Remova tudo que já está presente em profile.md, de forma generosa — se o perfil mencionar uma habilidade de qualquer forma, não é uma lacuna. O que resta é a lista de lacunas de habilidades técnicas: ordenada por pontuação no modo agregado, obrigatórias-antes-desejáveis e depois alfabética no modo direcionado.

Passo 4 — Passo 2: síntese

Raciocine sobre lacunas que a diffs não capturaria:

  • Conhecimento de domínio — setor ou espaço de problema desconhecido
  • Habilidades interpessoais — modos de trabalho, comunicação, liderança que o perfil não aborda
  • Ferramentas e processos — frameworks, serviços em nuvem, metodologias que aparecem em várias vagas
  • Credenciais — uma certificação que várias vagas listam como desejável

Marque cada uma com [dominio], [soft], [ferramentas] ou [credencial]. Não repita lacunas do Passo 1.

Passo 5 — Mapa de calor de lacunas

Combine ambas as passagens em uma tabela priorizada:

  • Crítico — habilidades técnicas com alta ponderação, ou uma lacuna de domínio na maioria das vagas
  • Alto — habilidades técnicas moderadas, ou lacunas consistentes de soft/ferramentas
  • Médio — habilidades técnicas de menor frequência, ou lacunas em poucas vagas
  • Baixo — menções isoladas
PrioridadeHabilidade / ÁreaTipoOrigem da Lacuna
CríticoKubernetesTécnica4/5 vagas, pontuação 3.2
AltoConhecimento de domínio em segurançaDomínioSíntese LLM
MédioAWS (avançado)Técnica2/5 vagas, pontuação 1.1
Baixo………

Imprima esta tabela antes de continuar, para que o usuário veja a partir do que você está trabalhando.

No modo direcionado, priorize a partir da própria linguagem da vaga: obrigatório → Crítico/Alto, desejável → Médio, inferido → Médio/Baixo.

Passo 6 — Plano de estudos

Cubra toda lacuna Crítica e Alta, mais as Médio se houver menos de cinco lacunas no total.

Para cada lacuna:

  1. Pesquise na web (WebSearch) recursos atuais e bem avaliados. Inclua o ano atual na consulta para que os resultados não estejam desatualizados. Exemplo de formato: "melhor curso de <habilidade> <ano> site:reddit.com OR coursera.org"
  2. Escolha 2–3 recursos. Prefira laboratórios práticos a apenas palestras; documentação oficial para lacunas de ferramentas; livros para lacunas de domínio. Dê nome, URL e uma linha sobre por que é adequado.
  3. Escreva uma direção de estudo adaptada ao que o candidato já sabe. Diga o que pular e por onde começar.
  4. Estime o tempo para proficiência operacional (~20h). Erre para cima.

Agrupe sob títulos temáticos em vez de ordem alfabética: Nuvem & Infraestrutura, MLOps, Conhecimento de Domínio, Segurança, Habilidades Interpessoais & Modos de Trabalho, Certificações.

### Nuvem & Infraestrutura

**Kubernetes** `[Técnica]` — ~20h
- [Recurso](url) — laboratórios práticos, mais práticos do que teóricos
- [Documentação oficial](url) — consulta assim que os fundamentos estiverem consolidados

Direção de estudo: conceitos básicos de contêiner já estão cobertos — comece pelo agendamento de Pods, depois
Serviços e Deployments. Domine manifests e `kubectl` antes de tocar no Helm.

Passo 7 — Ordem de estudo sugerida

  1. Dependências primeiro — se B precisa de A, coloque A primeiro e anote a dependência
  2. Crítico antes de Alto antes de Médio dentro de um nível
  3. Vitórias rápidas no início — uma lacuna Médio rápida pode vir primeiro para gerar impulso
  4. Conhecimento de domínio por último — estude-o junto com um projeto real
#TópicoTipoTempo Est.Nota
1KubernetesTécnica~20hNecessário antes do passo 3
2Pipelines CI/CDFerramentas~10h
3Conhecimento de domínio em segurançaDomínio~15hJunto com um projeto real

Tempo total estimado: ~45h

Passo 8 — Escrever e salvar o relatório

Ordem: cabeçalho e modo → desde o último relatório (apenas agregado) → mapa de calor de lacunas → plano de estudos → ordem de estudo sugerida.

  • Agregado: $JOB_SEARCH_HOME/upskill/relatorio-YYYY-MM-DD.md
  • Direcionado: $JOB_SEARCH_HOME/upskill/relatorio-YYYY-MM-DD-<slug-da-empresa>-<slug-do-cargo>.md — minúsculas, espaços para hífens, remova caracteres especiais

Seção de diffs, apenas agregado: lacunas fechadas são habilidades do mapa de calor anterior agora presentes no perfil; novas lacunas são entradas do mapa de calor atual ausentes no relatório anterior. Omita toda a seção quando não houver relatório anterior.

Confirme o caminho salvo para o usuário.

Regras

  1. Nunca invente recursos. Cite apenas o que a WebSearch realmente retornou.
  2. Pesquise com o ano atual em cada consulta de recurso.
  3. O modo direcionado ignora completamente o arquivo de rastreamento.
  4. Seja generoso com a correspondência do perfil. Uma habilidade mencionada de qualquer forma não é uma lacuna.
  5. Imprima o mapa de calor antes do plano de estudos.
  6. Sem recursos de estudo para lacunas Baixo a menos que solicitado.
  7. Sempre salve o relatório, mesmo que a saída do terminal pareça suficiente.
  8. Crie slugs de nomes de empresas a partir da vaga. Não invente ou adivinhe um.

Individual skills in this repo

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

SongGithub/personal-skills

Applies a direct, plain-spoken, Australian-English communication style to any text drafted — chat replies, emails, Slack/Teams messages, tickets, PR and commit descriptions, docs. Use whenever drafting prose, not just visual or code artifacts. Skip when the user explicitly asks for a different tone or voice.

SongGithub/personal-skills

A reusable HTML document design system for CVs, one-pagers and short reports — design tokens, layout, typography, print-to-PDF rules and accessibility. Use when generating or restyling a self-contained HTML document meant to be read on screen or printed to PDF.

SongGithub/personal-skills

End-to-end job application workflow. Screen a posting, tailor the HTML CV from the master template, print it to PDF, archive the artifact, and file the result against the configured tracker. Triggers on apply, apply to jobs, submit application, tailor and send CV.

SongGithub/personal-skills

CV attach workflow. Generate a tailored HTML CV for a tracked role, attach the rendered artifact back to its tracker item, then verify the attachment actually landed. Covers template selection, tailoring order, upload headers, and read-back verification.

SongGithub/personal-skills

First-principles reasoning for a startup or a job search, in the spirit of Elon Musk's "zero restart" framing: survival cashflow, the idiot index, and the physical first step. 第一性原理创业与求职法 — 从马斯克「归零重启」思维出发,用生存现金流、白痴指数、长期物理第一步三个步骤,指导创业和求职

SongGithub/personal-skills

How to file a job opportunity as a Jira issue — summary format, required fields, duplicate check, description formatting and attachments. Applies when tracker_backend is jira. Use when a job posting becomes a tracker record, and when creating or updating job records on a Jira board.

SongGithub/personal-skills

Assistant for job applications: evaluating job postings, tailoring CVs, writing cover letters, and preparing for interviews. Triggers on keywords like: job posting, job application, CV, cover letter, resume, interview prep, job fit, career, application, apply, SEEK

SongGithub/personal-skills

Job scraper. Searches job boards for new positions matching the candidate profile, deduplicates against previously seen jobs and the tracker file, then presents new matches with a quick fit assessment. Triggers on: job scrape, find jobs, search jobs, new jobs, /scrape.

SongGithub/personal-skills

Screen job opportunities, prepare job records and tailored CVs, and verify the result against current salary, title, source, and document-quality preferences. Applies to job boards and scheduled searches.

SongGithub/personal-skills

Trello card rules for the job-search tracker. Enforces case-insensitive and fuzzy duplicate detection before any card is created, title formatting, lane placement from config, and logging each card to the tracker database. Applies whenever a job posting becomes a card.

Habilidades Relacionadas