latex-cv-maintenance
Skill1 starsChanged 48 days agoMITView on GitHub
Use when reviewing, updating, or keeping consistent a multi-language LaTeX CV (altacv.cls). Covers treating Portuguese as source of truth and mirroring to other languages, cross-checking project/date/role data against the Lattes export, and verifying edits by compiling (latexmk/Makefile) and grepping pdftotext output.
In this repository125 other files it gives its agents.
- AGENTS.mdAGENTS.md
- skill-authoringSkill
- apple-notesSkill
- apple-remindersSkill
- findmySkill
- imessageSkill
- agy-customizationsSkill
- antigravity-guideSkill
- awesome-skills-masterSkill
- claude-codeSkill
- codexSkill
- computer-useSkill
- context-modeSkill
- dogfoodSkill
- hermes-agentSkill
- opencodeSkill
- rag-local-lancedbSkill
- skills-sh-registrySkill
- watermarks-removerSkill
- yuanbaoSkill
- libretranslate-markdown-i18nSkill
- mt-markup-preserving-translationSkill
- architecture-diagramSkill
- ascii-artSkill
- ascii-videoSkill
- baoyu-infographicSkill
- claude-designSkill
- comfyuiSkill
- design-mdSkill
- excalidrawSkill
- humanizerSkill
- manim-videoSkill
- p5jsSkill
- popular-web-designsSkill
- portfolio-github-pagesSkill
- pretextSkill
- sketchSkill
- songwriting-and-ai-musicSkill
- touchdesigner-mcpSkill
- jupyter-live-kernelSkill
- suap-iff-apiSkill
- desktop-themingSkill
- hermes-desktop-pluginsSkill
- docker-single-port-multi-instanceSkill
- hybrid-desktop-server-opsSkill
- himalayaSkill
- codebase-inspectionSkill
- git-conventional-commitsSkill
- github-authSkill
- github-code-reviewSkill
- github-issue-pr-attribsSkill
- github-issuesSkill
- github-profile-readmeSkill
- github-pr-workflowSkill
- github-repo-managementSkill
- github-starred-kbSkill
- hermes-installed-catalogSkill
- readme-templateSkill
- cv-latex-multilingualSkill
- gif-searchSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 155
CORREÇÃO: never use sed '...\n...' p/ newline.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
LaTeX CV Maintenance (multi-language, altacv)
Overview
Mantém um currículo em LaTeX baseado em altacv.cls quando há versões em múltiplos idiomas (ex.: portuguese.tex + english.tex) e um Lattes como fonte autoritativa de dados de projetos. Usado para revisar o CV em busca de itens faltando ou inconsistentes, espelhar edições entre idiomas e confirmar que as mudanças realmente entraram no PDF.
When to Use
- Usuário pede para "revisar o CV", "atualizar o currículo", "conferir inconsistências".
- Há um .tex por idioma e os outros são "tradução direta" de um deles (PT = fonte da verdade).
- Precisa garantir que projetos/datas/cargos batem com o Lattes.
- Criar novos idiomas (ex.: "cadê o ES e FR? crie-os traduzidamente") — o CV deste usuário
já tem 4 idiomas (PT/EN/ES/FR), cada um com wrapper
*CV.tex+page1sidebarXX.texdedicados. - Não usar para gerar o XML de importação do Lattes (ver skill
lattes-xml-projetos).
Workflow
- Localize os arquivos: o main (ex.: portugueseCV.tex) faz
\input{portuguese.tex}; há um .tex por idioma e sidebars (ex.: page1sidebar.tex / page2sidebar.tex) para a barra lateral. O build costuma ser um Makefile (make portugueseCV/make englishCV) comlatexmk -lualatex. - PT é a fonte da verdade. Edite primeiro o portuguese.tex; espelhe cada mudança em TODOS os
outros idiomas (english.tex, spanish.tex, french.tex — tradução literal, sem inventar conteúdo).
Trate como edição atômica em todas as línguas. Se o CV tiver 2 idiomas só (PT/EN), espelhe PT<->EN.
2b. Para CRIAR um novo idioma (ex.: ES/FR a partir do PT), replique a estrutura de um idioma existente:
XX.tex: copieportuguese.tex, troque\selectlanguage{brazilian}pelo idioma alvo (\selectlanguage{spanish}/\selectlanguage{french}) e traduza o corpo. Ajustehl=XXnos links (Google Scholar etc.) para o idioma.page1sidebarXX.tex: copiepage1sidebar.texe traduza (Premiações→Premios/Prix, Línguas→Idiomas/Langues...).XXCV.tex: wrapper que copiaportugueseCV.tex/englishCV.tex, mas com\usepackage[brazilian,<idioma>]{babel}(KEEPbrazilianprimeiro — o\selectlanguagedo\todayno corpo depende dele) e\input{XX.tex}.Makefile: adicioneXX_PDF := XXCV.pdf,XX_SRC := XXCV.tex, targetXXCVe$(XX_PDF)e inclua emall. Veja o padrão dos targetsspanishCV/frenchCVjá existentes. Tradução é DIRETA (não adapte conteúdo). Não invente dados.
- Cross-check com o Lattes (XML ou export): confira título, período (ano/mês), cargo (Bolsista vs Voluntário), orientador(es) e natureza (Pesquisa/Extensão) de cada projeto. O CV tende a defasar quando o projeto é renomeado ou a data muda no Lattes.
- Aplique nas duas línguas e nos sidebars se a informação aparecer lá (ex.: premiações citam o título de um projeto — o título deve bater em ambos os lados).
- Verifique (obrigatório): compile e extraia o texto para confirmar que a edição entrou no PDF.
Receita em
references/verify-recipe.md. - Mantenha também as versões em Markdown sincronizadas (preferência do usuário): o repo tem
README.md(com o CV embutido em md na seção "CV em Markdown") ecurriculo.md(CV standalone em md). Ao mudar conteúdo no LaTeX, replique a mesma alteração nesses .md — o usuário os usa como fonte legível/portátil. OREADME.mdtambém documenta o build multi-idioma (tabela de arquivos por idioma + targets do Makefile).
Estrutura altacv relevante
\cvevent{Título}{Instituição}{Período}{Local}— o Período usa{Mês. Ano -- presente}(hífen duplo; em inglêspresent, em portuguêspresente). Ano-only também ok:{2024 -- presente}.- Sidebar:
\\cvsection,\\cvachievement,\\cvtag,\\cvskill. - Build (Makefile,
latexmk -lualatex):make portugueseCV/make englishCV/make spanishCV/make frenchCV/make all. Cada idioma tem wrapper*CV.tex+page1sidebarXX.tex.
Layout / espaçamento (ajustes comuns de altacv)
altacv deixa o layout "quebradico" em 3 situações típicas — corrija assim:
- Colunas
multicolsesticadas (espaço em branco entre itens): o ambientemulticolsequaliza a altura das colunas esticando o espaço vertical. Adicione\raggedcolumnslogo após cada\begin{multicols}{2}(Formação, Projetos, Eventos). Isso alinha pelo topo e elimina o espaço extra. Ex.:\begin{multicols}{2}\raggedcolumns. - Espaço solto entre um sub-cabeçalho e o conteúdo (ex.: "Proceedings" → referência da
bibliografia): o
\cvsubsectioninsere\medskipdepois do título. Substitua por um cabeçalho compacto inline:\textbf{\large\color{emphasis}Proceedings}\par\vspace{0.2\baselineskip}seguido do conteúdo. (Use para seções de Publicações; para sub-cabeçalhos de Eventos, manter\cvsubsectioné OK.) - Página 2 com 2/3 vazios (ex.: Publicações + sidebar, coluna esquerda curta): mova uma seção da página 1 para depois das Publicações (página 2) para balancear. Neste CV, as "Áreas de Interesse / Research Interests / Domaines d'Intérêt / Áreas de Interés" foram movidas do final da página 1 para após a bibliografia na página 2 — equilibrou a coluna.
\dividerredundante antes de\cvsubsection: em Eventos, o\dividerantes do sub-cabeçalho "Congressos" cria um buraco grande. Remova-o; o\cvsubsectionjá separa visualmente. (Mantenha os\dividerentre itens do mesmo sub-cabeçalho.)- Disclaimer de tradução automática: em idiomas DERIVADOS (não o PT fonte), o usuário quer
um rodapé itálico informando tradução por IA. Ex. (ES, no final do arquivo, antes de
\clearpage):\vspace{1em}\footnotesize\itshape Traducción automática generada por IA a partir de la versión en portugués del currículo.(FR):...Traduction automatique générée par IA à partir de la version portugaise du curriculum vitae.PT e EN não levam disclaimer.
Pitfalls
- "Voluntário ... CNPq" é contraditório — CNPq concede bolsa, não voluntariado. Use "Bolsista CNPq". (No EN: "Scholarship ... CNPq", nunca "Volunteer".)
- Drift de data: o CV costuma ficar 1-2 anos atrás do Lattes quando o projeto é renomeado/mudado. Sempre cruze com a fonte antes de "consertar" só o texto solto.
- Título grudado no ano:
"... com Aprendizado de Máquina 2025"— o "2025" é typo dentro do título; removê-lo e usar o campo de período. - Mirror drift: se editou só o PT e esqueceu o EN (ou vice-versa), as versões divergem.
- Título truncado na tradução: ex.: "Astronomical" deveria ser "Astronomical Observations". Revise o EN com cuidado, não só copie.
- hl=pt-BR em links do EN (ex.: Google Scholar
hl=pt-BR) — cosmetic, mas no EN prefirahl=en. - Não confie só no "up-to-date" do latexmk: após editar, force rebuild (
rmdos aux) e confira o PDF. - babel em novo idioma: mantenha
brazilianPRIMEIRO em\usepackage[brazilian,<idioma>]{babel}mesmo no wrapper de outro idioma — o\selectlanguage{<idioma>}no corpo (e o\todayformatado) depende de o brazilian estar carregado. Sem isso,\todaynão formata ou quebra o build. - Verificação frágil via grep/pdftotext dá FALSO-NEGATIVO:
pdftotextexporta cabeçalhos de\\cvsectionem MAIÚSCULAS, converte apóstrofo reto em tipográfico (’) e QUEBRA LINHAS no meio de títulos longos. Greps case-sensitive ou com apóstrofo reto falham. Use o script de normalização emreferences/verify-recipe.md(remove acentos via NFD, casefold, colapsa pontuação/espaço) — assim substrings sobrevivem a quebras e apóstrofos. Nunca declare "FALHOU" sem antes confirmar com o texto extraído cru (ex.:pdftotext X.pdf - | grep -i "trecho" | cat -A). - Mover seção entre páginas apaga o
\end{multicols}vizinho (BUG REAL desta sessão): ao cortar uma seção do final da página 1 (ex.: remover "Áreas de Interesse" de antes do\end{fullwidth}), é fácil incluir o\end{multicols}da seção ANTERIOR (Eventos) no bloco removido. Sintoma:! LaTeX Error: \begin{multicols} on input line N ended by \end{list}e o PDF some. Sempre reinsira o\end{multicols}imediatamente antes do\end{fullwidth}da seção cuja coluna você mexeu. Dica: após qualquer remoção de bloco, confira se cada\begin{multicols}{2}tem seu\end{multicols}correspondente (conte os pares). \begin{fullwidth}órfão quebra TODO o documento: se você removeu um\end{fullwidth}(ex.: ao reescrever uma seção) mas deixou o\begin{fullwidth}correspondente, o ambientelistinterno do fullwidth fica aberto até\end{document}→! LaTeX Error: \begin{list} on input line N ended by \end{document}+ erro fatal "Undefined control sequence". Isso TRAVA o primeiro lualatex (exit 1), o.aux/.bcfnão é escrito e, em cascata, o biber gera.bblvazio ("Empty bibliography") — por isso as referências somem. SEMPRE mantenha begin/end de fullwidth balanceados (conte os pares). Ao reescrever Eventos removendo o\end{fullwidth}antigo, reinsira\end{fullwidth}logo antes de\newpage/Publicações.\\solto dentro de\cvtag{...}:\cvtag{Física Computacional} \\(double backslash no fim da linha, fora de contexto de quebra de linha) causa "Undefined control sequence" ou "There's no line here to end". Remova o\\— o altacv já quebra os cvtags sozinho.\\dentro de\tagline{...}(cabeçalho): o altacv processa o tagline como texto; um\\no meio pode quebrar. Prefira texto corrido ou\newlinedentro de grupo se preciso.- "Undefined control sequence" que só aparece VIA
\input(não inline) — técnica de isolar: Quando o corpo é incluído por\input{portuguese.tex}(padrão do Makefile), o LaTeX atribui o erro à linha do\inpute ESCONDE a linha real do comando indefinido, dificultando o debug. Para achar a linha real: gere ummain_TEST.texcom o PREÂMBULO do main.tex (até\begin{document}) + o CONTEÚDO do corpo embutido (sem\input) e compile. Se compilar limpo inline mas quebrar via\input, o culpado é um caractere invisível/BOM no início do arquivo de conteúdo (o Python normaliza ao ler/gravar, o\inputnão). Confirme comod -cno início do .tex e limpe comsed -i '1s/^\xEF\xBB\xBF//'ou reescreva o arquivo. Isolamento binário: comente seções progressivamente (do fim pro início) e recompile até o erro sumir — a última seção removida é a culpada. - Não declare "compilou" só porque
makeimprimiu "Generated": com>/dev/null 2>&1e|| trueno recipe, o make esconde exit≠0 e um PDF de fallback (incompleto) é escrito. Sempre chequeecho $?ou rode uma passada de lualatex visível e confirmeEXIT=0+ conte as citações no PDF (pdftotext X.pdf - | grep -c '\[\\d+\]'). - BUG CRÍTICO do Makefile:
sedque insere\\nLITERAL (barra-n como texto) — bug raiz desta sessão; faz as referências SUMIREM silenciosamente. O padrãosed 's/\\end{document}/\\input{<lang>}\\n\\end{document}/'NÃO interpreta\ncomo newline em muito sed/GNU — escreve a string literal\n. No main_<lang>.tex resulta\\input{portuguese.tex}\\n\\end{document}onde o\né o comando\n(undefined) →! Undefined control sequenceFATAL no PRIMEIRO lualatex (exit 1). O.aux/.bcfnão é escrito, o biber lê 0 citekeys →.bblvazio → "Empty bibliography" + 0 referências no PDF. O corpo embutido INLINE (sem\\input) compila limpo — só falha via\\input, o que confunde o debug. CORREÇÃO: never usesed '...\n...'p/ newline. Useawkp/ inserir o\\inputcom newline REAL antes de\\end{document}:awk '/\\end\\{document\\}/{print "\\input{'$*'}"} {print}' main_$*.tex > tmp && mv tmp main_$*.tex($*expandido pelo make; awk imprime\\input{portuguese}em linha própria,{print}reimprime\\end{document}). Makefile canônico emreferences/makefile-biber-awk.md. DICA diagnóstico: semakediz "Generated" mas o PDF tem 0 citações, rode passada visívellualatex -interaction=nonstopmode -jobname=X main_X.tex 2>&1 | grep -i undefined; se aparecer, o main_X.tex tem\nliteral ou comando inválido — confirme comgrep -n '\\input' main_X.tex. \\nocite{*}vs citações nos eventos: ao reescrever uma seção (ex.: Eventos) com comando custom (\\evento), é fácil PERDER os\\cite{...}que vinculavam o evento à referência. Se o PT tem\\nocite{*}comentado e os\\cite{}sumiram, o biber acha 0 citekeys → bibliografia vazia. Opções: (a) reativar\\nocite{*}no PT (mostra TODAS as entradas do .bib — o que o usuário quer), ou (b) reinserir os\\cite{Chave}nos args do\\evento.\\nocite{*}é a mais robusta.- Layout de Publicações em 2 colunas (publicações + sidebar) — substitua
[page1sidebar]:\\cvsection[page1sidebarXX]{Publicações}usa\\marginpar, que SOME se a página estiver quase vazia (ex.: após\\newpage, a pág final só tem o resto das referências). Para GARANTIR a sidebar na última página DIVIDINDO o espaço, useminipageexplícito DENTRO defullwidth: `\begin{fullwidth}\cvsection{\faFile*\ Publicações}\begin{minipage}[t]{0.63\linewidth}
<link ADS + \\nocite{*} + \\printbibliography...> \\end{minipage}\\hfill
\\begin{minipage}[t]{0.33\\linewidth}\\input{page1sidebarXX}\\end{minipage}\\end{fullwidth}`.
Fixa publicações à esquerda e sidebar à direita, sem depender de marginpar. Verificado PT/EN/ES/FR.
19. **Corrupção de escaping em edições de `.tex` via `patch` tool**: ao usar a tool `patch`
num arquivo denso em barras invertidas (ex.: definição de `\\evento` em `main.tex`), o `patch`
pode DEVOLVER barras DOBRADAS (`\\` → `\\\\`) em vez de substituir — especialmente quando o
`old_string`/`new_string` também contém `\\`. Sintoma: `! Undefined control sequence` ou
`! LaTeX Error: There's no line here to end` em TODAS as entradas que usam o comando.
**FIX**: reescreva o arquivo inteiro com `write_file` (sobrescreve tudo, barras corretas) ou
use `execute_code` com `io.open` (Pitfall #6 do `cv-latex-multilingual`). NUNCA confie em
`patch` para trocar trechos densos em `\\`; valide com `grep -n '\\\\\\\\' arquivo.tex` após editar.
20. **Espaçamento entre entradas de comando customizado + título de seção colado no conteúdo**:
- Entre itens de uma lista custom (`\\evento`, `\\cvevent`): use `\\par\\medskip` no fim de cada
entrada (não só `\\smallskip`) — dá o "respiro"/breakline que o usuário pediu. Confirmado por
inspeção visual (PT pág 2: eventos não colados).
- Título de seção isolado do conteúdo (ex.: "Publicações" numa página, referências na seguinte):
o `\\cvsection{...}` + bloco grande abaixo transborda. **FIX**: insira `\\nopagebreak` logo
após o `\\cvsection{...}` (antes do `\\begin{minipage}`), e remova `\\newpage` DUPLICADO que
cria a quebra errada. Assim título e conteúdo ficam na mesma página.Build: ciclo de bibliografia (BIBER) e Makefile
O CV usa biblatex (backend biber) com \addbibresource{sample.bib} + \printbibliography.
A referência SÓ aparece no PDF se o ciclo rodar biber ENTRE as passadas do lualatex:
lualatex → biber <jobname> → lualatex → lualatex.
latexmk -lualatexNÃO dispara biber de forma confiável neste repo (o PDF sai sem a lista bibliográfica / "Empty bibliography"). Use o ciclo explícito no Makefile (Makefile canônico comawkemreferences/makefile-biber-awk.md— NÃO usesedcom\n, ver Pitfall 16). Se usarlatexmk, force-bibtexou rode biber à mão.- Sintoma de biber não rodado:
LaTeX Warning: Empty bibliography on input line Ne 0 citações no PDF (o\nocite{*}comentado em PT significa que só entradas citadas aparecem; EN/ES/FR têm\nocite{*}ativo). - Build artifacts
main_<lang>.texsão gerados dinamicamente pelo Makefile (sed em cima do main.tex) — NÃO versionar (já no.gitignore).
Sidebar ([page1sidebar]) e página da bibliografia
\cvsection[page1sidebar]{Publicações}injeta o arquivo como\marginpar(lado direito). Se a página estiver CHEIA de referências, a marginpar não cabe e a sidebar SOME (lado direito em branco). Para garantir a sidebar na ÚLTIMA página junto das Publicações, insira\clearpage(ou\newpage) ANTES do\cvsection[page1sidebar]{...}.- Sidebar multi-idioma: o argumento
[page1sidebar]aponta SEMPRE parapage1sidebar.tex(português). Para traduzir a sidebar, criepage1sidebarEN.tex/page1sidebarES.tex/page1sidebarFR.texe use\cvsection[page1sidebarEN]{...}etc. em cada idioma. Reverter a sidebar para "Publicações" (saindo do "Resumo Acadêmico") exige trocar o argumento em TODOS os 4 idiomas — não esqueça de apontar para o arquivo traduzido. - Para seção de Publicações em página dedicada:
\end{fullwidth}(fecha o fullwidth do corpo)\newpage+\cvsection[page1sidebarXX]{Publicações}.
Verification (ad-hoc, via pdftotext — método robusto)
Veja references/verify-recipe.md para o script Python de normalização e
references/build-biber-debug.md para o ciclo de Makefile com biber e a técnica de isolar
"Undefined control sequence" escondido pelo \input. Em resumo:
- Compile todos os idiomas tocados:
make portugueseCV englishCV spanishCV frenchCV(exit 0 = compila). - Confirme o texto novo no PDF com o script normalizado (acentos/apóstrofo/quebra de linha não quebram a busca).
- Sem
pdftotext/Python, abra o PDF ou use inspeção visual — mas NÃO use grep case-sensitive cru, poispdftotextemite cabeçalhos em MAIÚSCULAS e apóstrofo tipográfico (ver Pitfall 9).
Related
lattes-xml-projetos: gera/valida o XML de importação do Lattes (mesma fonte de dados de projetos; o geradorgerar_projeto_lattes.pyembute a lista canônica de projetos — use-a como referência antes de mexer no CV).
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

