Communitygithub.com

Peytontalismanic424/paper-share-skills

Pipeline automatizada: artigo (PDF ou fonte TeX) → slides Beamer no tema SUSTech (estrutura 论文分享 de 11 seções) → PDF compilado. Quando a fonte TeX está disponível, o MinerU é ignorado e o conteúdo é extraído diretamente do LaTeX.

O que é paper-share-skills?

Esta skill automatiza a conversão de artigos acadêmicos (PDF ou fonte TeX) em uma apresentação Beamer completa no tema SUSTech, seguindo a estrutura padrão de 11 seções para seminários de leitura (论文分享). Quando a fonte TeX está disponível (arquivo .tar.gz ou .tex), a skill extrai o conteúdo diretamente do LaTeX, preservando tabelas e estruturas complexas com precisão superior ao MinerU. Caso contrário, utiliza o MinerU para converter o PDF em Markdown. A skill baixa automaticamente fontes TeX do arXiv (dado um ID ou URL), instala o template de slides Beamer offline, e guia a criação de slides com seções pré-definidas (resumo, motivação, método, experimentos, etc.). Recursos avançados incluem pesquisa online obrigatória para biografias de autores, geração de figuras dedicadas em slides separados, e verificação rigorosa contra estouro de slides. O resultado é um diretório organizado contendo o PDF compilado e todos os arquivos-fonte. Suporta macOS, Linux e Windows (via Git Bash).

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Peytontalismanic424/paper-share-skills/tree/HEAD/paper-to-beamer

Perguntar na sua IA favorita

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

Prévia

Do README da skill

paper-share-skills preview

Documentação

Pipeline: Artigo → Slides Beamer

Dado um artigo (PDF ou fonte TeX), produzir uma apresentação Beamer compilada no tema SUSTech em 论文分享/<VENUE> - <SHORT_TITLE>/.

Variante do tema: \usetheme{sustech} (minúsculo, Variante A), de https://github.com/yhbcode000/sustech-slides-template.git. NÃO use \usetheme{SUSTech} (Variante B, usada no MT3) — tem macros diferentes e não possui páginas separadoras de seção.

Proporção de aspecto padrão: aspectratio=1610 (16:10). NÃO use 169 (16:9) — 1610 é preferido para compatibilidade com laptop/projetor e oferece um pouco mais de espaço vertical para conteúdo denso.

Runtime Bash: Todos os comandos shell são executados sob a ferramenta bash da sessão, que no Windows é o Git Bash. Comandos Unix rm -rf, cp -r, mkdir -p estão disponíveis. O diretório de trabalho é definido por bloco via cwd.

Requisitos (OBRIGATÓRIOS)

Todo slide deck DEVE satisfazer estas regras. Sem exceções, exceto onde indicado.

  1. Sem estouro de slide (rigoroso) — todos os slides DEVEM compilar sem avisos Overfull \hbox ou Overfull \vbox. Siga skill://sustech-beamer-overflow: apenas coluna única, máximo 3 blocos + 1 callout, tabelas ≤5 colunas com \footnotesize, sem \resizebox. A ÚNICA exceção é a página de índice/TOC (layout \twopane) — um leve estouro vertical (Overfull \vbox) no quadro TOC é tolerado.

Fase 1 — Configuração do diretório

  1. Aceite $ARGUMENTS — um caminho de PDF, arquivo .tar.gz TeX ou arquivo .tex (absoluto ou relativo ao cwd da sessão), ou uma URL do arXiv / ID arXiv simples.

  2. Se a entrada for uma URL do arXiv ou ID simples (corresponde a ^\d{4}\.\d{4,5}(v\d+)?$ ou contém arxiv.org/(abs|pdf|e-print)/), baixe a fonte TeX primeiro:

    uv run --no-project python \
      "<SKILLS_DIR>/paper-download-arxiv-paper-source/scripts/download_source.py" \
      "<arxiv-ref>"        # saída padrão = cwd da sessão
    
    • Se stdout terminar com TEX_SOURCES:: derive DIR_NAME — veículo de \setsource{Venue}{Year} no TeX extraído de paper_src/ (fallback \markboth, depois arXiv <year>); título curto = primeiras 1–3 palavras significativas de \title{...} (fallback: pergunte ao usuário, regra existente). Então mkdir -p "论文分享/<DIR_NAME>" e mv arXiv-<id>.tar.gz paper_src "论文分享/<DIR_NAME>/".
    • Se stdout terminar com PDF_ONLY: <path>: o artigo não tem fonte TeX no arXiv — copie esse PDF para 论文分享/<DIR_NAME>/ conforme o ramo .pdf abaixo (o caminho MinerU se aplica, Fase 2 DECISION GATE inalterada).
    • Se o comando sair com código diferente de zero: pare e reporte a mensagem de stderr ao usuário.
  3. Derive um nome de diretório curto <VENUE> - <SHORT_TITLE> (entradas arXiv já derivaram na etapa 2):

    • Remova .pdf / .tar.gz / .tgz / .tex, substitua espaços/hífens/caracteres especiais.
    • Pergunte ao usuário pelo nome se veículo/título não forem inferíveis do nome do arquivo.
    • Convenção: exemplos existentes são SCIENCE ROBOTICS - HIL SERL, SCIENCE ROBOTICS - MT3.
  4. Crie 论文分享/<DIR_NAME>/ e extraia/copie a fonte lá (entradas arXiv já moveram o arquivo + paper_src/ na etapa 2):

    • .tar.gz / .tgz: extraia com tar -xzf para paper_src/.
    • .pdf: copie diretamente para a raiz do diretório do artigo.
    • .tex: copie os arquivos fonte para paper_src/.

Fase 2 — Extração de conteúdo

DECISION GATE: Se a fonte TeX estiver disponível (arquivo .tar.gz contendo .tex, ou arquivo .tex direto), pule o MinerU completamente. Leia todo o conteúdo (título, autores, resumo, seções, tabelas, referências) diretamente da fonte TeX usando read — é mais preciso que a saída do MinerU e preserva estruturas de tabela exatamente.

Execute o MinerU apenas quando a entrada for um PDF sem fonte TeX disponível:

"$MINERU_PYTHON" \
  "<SKILLS_DIR>/pdf-to-markdown/convert.py" \
  "论文分享/<DIR_NAME>/<pdf_filename>.pdf" \
  "论文分享/<DIR_NAME>/md_output" \
  --lang en
  • Artigos em inglês: --lang en. Chinês/misto: --lang ch.
  • O wrapper imprime DONE -> ...md em caso de sucesso.
  • A saída vai para md_output/<name>/auto/<name>.md.

Se o ambiente MinerU estiver ausente, pare e informe ao usuário para instalá-lo conforme as instruções da skill pdf-to-markdown.



Fase 3 — Instalar o template empacotado

O pacote promovido paper-to-beamer é a fonte primária e offline do template:

uv run --project "<SKILLS_DIR>/paper-to-beamer" python \
  "<SKILLS_DIR>/paper-to-beamer/scripts/copy_template.py" \
  --output "论文分享/<DIR_NAME>/slides-template"

Isso copia o pacote verificado main_template.tex, latexmkrc e sustech-theme/. Um clone de rede nunca é um fallback. Apenas quando o usuário solicitar explicitamente uma atualização do template, o repositório upstream poderá ser clonado em um diretório temporário separado para revisão antes do lançamento do pacote.


Fase 4 — Criar diretório de trabalho e copiar itens essenciais

# cwd: $PP_ROOT
mkdir -p "论文分享/<DIR_NAME>/slides-beamer"
cp -r "论文分享/<DIR_NAME>/slides-template/sustech-theme" \
  "论文分享/<DIR_NAME>/slides-beamer/"
cp "论文分享/<DIR_NAME>/slides-template/latexmkrc" \
  "论文分享/<DIR_NAME>/slides-beamer/"
cp "论文分享/<DIR_NAME>/slides-template/main_template.tex" \
  "论文分享/<DIR_NAME>/slides-beamer/main.tex"
mkdir -p "论文分享/<DIR_NAME>/slides-beamer/figures"

Todas as edições subsequentes devem ter como alvo apenas slides-beamer/. slides-template/ é mantido intacto como referência.


Fase 5 — Ler e extrair conteúdo

Quando a fonte TeX estiver disponível (preferencial — arquivo .tar.gz ou arquivo .tex): leia o .tex principal de paper_src/ diretamente usando read. Todo o conteúdo (título, autores, resumo, seções, tabelas, referências) é extraído da fonte LaTeX estruturada. Tabelas podem ser recriadas diretamente de ambientes tabular — sem necessidade de MinerU.

Quando apenas Markdown estiver disponível (entrada apenas PDF): leia md_output/<name>/auto/<name>.md. Extraia estes pontos de dados:

Fase 6 — Preencher slides-beamer/main.tex

Esta é a fase criativa central. Leia main.tex (copiado do template), depois edite-o seção por seção para substituir cada placeholder \ph{…} e \phfig por conteúdo real do Markdown.

Use o exemplo HIL SERL como referência de estilo preenchido: 论文分享/SCIENCE ROBOTICS - HIL SERL/slides-beamer/main.tex.

6.0 Metadados do preâmbulo

  • \title[ACRONYM 论文分享]{Chinese descriptive title} — título chinês como principal; título curto DEVE incluir o sufixo "论文分享". Siga HIL SERL: \title[HIL-SERL 论文分享]{...}.
  • \subtitle{English original paper title} — título original em inglês como subtítulo.
  • \author[short]{…} — lista completa de autores do artigo.
  • \institute[short]{…} — instituições principais.
  • \setsource{Venue}{Year} — veículo do artigo.
  • \setdomains{\domaintag{...}\domaintag{...}\domaintag{...}} — 3-4 tags de domínio de pesquisa exibidas na página de título como pills coloridas. Tags DEVEM estar em chinês (ex.: 多智能体RL, LLM Agent, RL后训练). Termos em inglês como Multi-Agent RL, RL Post-Training NUNCA são permitidos — parecem inconsistentes ao lado do texto chinês e quebram o estilo de apresentação bilíngue do tema SUSTech.
  • \setpresenter{$PRESENTER} (padrão) ou pergunte ao usuário.
  • \setvenue{<venue location>} (padrão: pergunte ao usuário).
  • Nota de rodapé da página de título \creditline (padrão: 哔哩哔哩 · 白拾的物理AI组会 · github.com/yhbcode000/sustech-slides-template). Para compartilhamento público/publicação de vídeos, recomenda-se manter; para apresentações/defesas que exigem layout limpo, adicione \hidecredits no preâmbulo para desativar, ou \setcreditline{} para esvaziar, \setcreditline{...} para personalizar o texto.

Apague os macros auxiliares de placeholder \ph e \phfig — eles não são mais necessários.

6.1 首页 (Página de título)

O quadro \titlepage permanece como está. Os metadados do preâmbulo o controlam.

6.2 📑 目录页(TOC Aprimorado)

O template agora usa um layout de dois painéis \twopane (do tema). O painel esquerdo contém um TOC compacto via {\tocdense\small\tableofcontents[hideallsubsections]}. O painel direito contém três blocos:

  1. \block{核心观察} — 3-5 métricas/insights principais do artigo
  2. \block{附录讨论} — 3-5 destaques do apêndice (sinal Oral, comparações, explicadores de método)
  3. \callout[一句话概括] — resumo do artigo em uma frase

O quadro separado 论文信息 é DELETADO. Título/veículo/autores já estão no preâmbulo. O resumo em uma frase vive no callout do TOC. Nenhum quadro de informações separado é necessário.

Espaçamento do TOC: Use {\tocdense\small\tableofcontents[hideallsubsections]} — \tocdense (do tema) compacta o espaçamento do TOC do beamer. Prefixe com \vspace{-0.6em} para puxar o conteúdo para cima, mais próximo do título.

Margem esquerda: O \tocdense do tema adiciona \hskip2em margem esquerda para um layout de TOC equilibrado.

6.3 👤 作者介绍 — VALIDAÇÃO CRUZADA ONLINE ANTES DE ESCREVER

CRÍTICO: Você DEVE pesquisar online por biografias de autores ANTES de escrever este quadro. Os PDFs dos artigos fornecem apenas nomes e afiliações — faltam nomes chineses, cargos atuais, trabalhos notáveis anteriores, nomes de laboratórios e reconhecimentos recentes. Entradas genéricas como "Universidade Tsinghua, primeiro autor" são INACEITÁVEIS.

Procedimento de pesquisa (execute ANTES de escrever o quadro):

  1. Escreva para xd://web_search com {"query": "<primeiro autor> <instituição> <domínio do artigo>", "limit": 5} — obtenha nome chinês, cargo atual, trabalho anterior, laboratório.
  2. Escreva para xd://web_search com {"query": "<autor corr 1> <instituição>", "limit": 5} — o mesmo para cada autor correspondente.
  3. Cruzar referências de pelo menos 2 fontes por autor. Prefira páginas pessoais ou Google Scholar.
  4. Pesquise também via xd://web_search com {"query": "<instituição> <laboratório/prof> <domínio>", "limit": 5} para contexto do laboratório.

O que extrair dos resultados da pesquisa:

  • Nome chinês (PDFs de artigos frequentemente não têm caracteres chineses)
  • Cargo atual (professor assistente? estudante de doutorado? indústria? a afiliação do artigo pode estar desatualizada)
  • Trabalho anterior notável (pelo que esta pessoa é conhecida? ex.: MAPPO, RLinf, GRPO)
  • Nome do laboratório/grupo (ex.: EDI Lab, NICS-EFC, RAIL)
  • Reconhecimentos recentes (artigos em grandes veículos, prêmios, cargos de liderança)

Preencha o quadro com biografias telegráficas e referenciadas:

\begin{frame}{作者介绍}
  \begin{block}{核心作者}
    \begin{itemize}
      \item \shl{<primeiro autor>}(<chinês>):<departamento>, <cargo>. Conhecido por \keyword{<trabalho anterior>}. Neste artigo, <papel>.
      \item Colaboradores de <instituições>, formando uma equipe <descrição>.
    \end{itemize}
  \end{block}
  \tightgap
  \begin{block}{通讯作者}
    \begin{itemize}
      \item \shl{<corr 1>}(<chinês>):<cargo> @ <inst>, PI do <lab>. Áreas de pesquisa: \keyword{<a1>}、\keyword{<a2>}.<trabalho notável>. Neste artigo, <papel>.
      \item \shl{<corr 2>}(<chinês>):<cargo> @ <inst>, <lab>.<notável>. Neste artigo, <papel>.
    \end{itemize}
  \end{block}
  \tightgap
  \begin{callout}[研究脉络]
    <trajetória da equipe levando a este artigo>.
  \end{callout}
\end{frame}

6.4 📋 背景与动机

Mapeie para a seção 研究背景与动机 no template:

  • Defina \renewcommand{\secblurb}{…} (resumo de uma frase) antes de \section.
  • Preencha placeholders de bullet com motivação telegráfica do resumo/introdução.
  • Mova a figura para um slide dedicado [plain,c] após este slide de conteúdo: \fitfigure{fig1_overview.jpg} + \figcap{1}{legenda}. Remova o wrapper \begin{columns} — este slide permanece apenas texto.
  • Preencha \metric{…}{…} com até 3 números-chave do artigo.

6.5 相关工作

Mapeie para a seção 相关工作:

  • Liste áreas de pesquisa da seção de Trabalho Relacionado do artigo.
  • Liste métodos de baseline reais e suas relações.
  • Declare o principal diferencial no callout.

Se o artigo tiver uma seção clara "Related Work", use-a. Caso contrário, condense a partir de referências dispersas na introdução.

6.6 🔧 方法

Mapeie para a seção 方法 (2 quadros: visão geral + design central).

Quadro 1 (Visão geral):

  • Liste componentes do sistema da seção de método do artigo.
  • Mova a figura para um slide dedicado [plain,c] após este slide de conteúdo: \fitfigure{fig2_system.jpg} + \figcap{2}{legenda}. Remova o wrapper \begin{columns}.

Quadro 2 (Design central):

  • Liste até 4 elementos de design principais.
  • Adicione um resumo de uma linha no callout.

6.7 🧪 实验设计

Mapeie para a seção 实验设计:

  • Liste categorias de tarefas/conjuntos de dados.
  • Declare o protocolo de avaliação e baselines.
  • Mova a figura para um slide dedicado [plain,c] após este slide de conteúdo: \fitfigure{fig3_tasks.jpg} + \figcap{3}{legenda}. Remova o wrapper \begin{columns}.

6.8 📈 结果与分析

Mapeie para a seção 实验结果 (2 quadros: tabela principal + análise).

Quadro 1 (Tabela principal):

  • Recrie a tabela com dados reais do artigo.
  • Mantenha ≤5 colunas, ≤6 linhas.
  • Destaque os melhores resultados com \shl{…}.
  • Use \theadrow, \altrow, \thc{…} com booktabs.
  • Conclusão de uma linha no callout.

Quadro 2 (Análise):

  • Análise em bullet points (3–4 observações).
  • Figura de análise em um slide dedicado [plain,c] após os bullets de análise.

6.9 💡 要点总结

Mapeie para a seção 要点总结 (corresponde a "核心贡献"):

  • 3 takeaways principais enumerados.
  • Resumo de uma frase no callout.

6.10 ⚠️ 局限与讨论

Mapeie para a seção 局限性:

  • 3–4 limitações.
  • Direções futuras identificadas pelos autores no callout.

6.11 📚 参考文献

Mapeie para o quadro 参考文献:

  • Preencha entradas bibitem com referências reais do artigo.
  • O primeiro bibitem deve ser o próprio artigo (marcado (本文)).
  • Inclua 3–5 baselines principais.

6.12 💬 Q&A

Substitua o texto placeholder no quadro Q&A por:

  • Nome do apresentador, instituição, informações de contato.
  • Mantenha a estilização Q&A (\fontsize{40}{44} etc.).

6.13 Manipulação de figuras

Para cada placeholder que precisa de uma figura:

  1. Fonte TeX disponível (preferencial): copie figuras de paper_src/figures/ para slides-beamer/figures/ com nomes semânticos: fig1_overview.pdf, fig2_system.pdf, etc. Fontes TeX usam figuras vetoriais .pdf — qualidade superior.
  2. Markdown disponível: liste imagens de md_output/<name>/auto/images/. Cada uma é um .jpg com nome hash. Escolha a figura relevante inspecionando com inspect_image ou a partir das referências ![](images/...) do markdown. é APENAS para quadros de conteúdo onde a figura compartilha espaço com texto.
  3. Coloque a figura em seu próprio slide dedicado — NUNCA dentro de um bloco \begin{columns}:
    \begin{frame}[plain,c]
      \centering
      \includegraphics[height=0.92\textheight,width=\textwidth,keepaspectratio]{filename}
      \figcap{N}{texto da legenda}
    \end{frame}
    

Se uma figura estiver faltando ou não puder ser capturada, insira um callout placeholder em seu lugar (o auxiliar \phfig foi deletado em 6.0, então NÃO o referencie

Individual skills in this repo

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

Peytontalismanic424/paper-share-skills

Validate and upload narrated paper videos to Bilibili with biliup. Handles required landscape-first/portrait-second submissions, series uploads, CST scheduling, diagnostics, dry-run validation, and durable upload receipts. Trigger on: "upload to bilibili", "bilibili upload", "发布到B站", "上传到B站".

Peytontalismanic424/paper-share-skills

Download the TeX source (e-print tar.gz) of an arXiv paper from an arXiv URL or bare ID, and unpack it into paper_src/. Use FIRST whenever a pipeline input is an arXiv link and the TeX source is preferred over the PDF (paper-to-beamer, paper-to-bilibili, paper-venue-discovery). Invoke with an arXiv URL (abs/pdf/e-print, arxiv.org or export.arxiv.org) or a bare ID like 2509.07996v4.

Peytontalismanic424/paper-share-skills

Convert Beamer PDF slides into a fail-closed narrated MP4 with page-aligned narration, TTS audio, cover, and upload metadata. Trigger on narrated slides, slide video, or paper video requests.

Peytontalismanic424/paper-share-skills

Orchestrate a paper PDF through MinerU, SUSTech Beamer slides, complete Chinese narration, landscape and portrait video, metadata gates, and Bilibili upload. Supports single-paper and batch slides, video, or bilibili phases. Trigger on full paper-to-Bilibili requests, PDF-to-video publication, and batch paper publishing.

Peytontalismanic424/paper-share-skills

Generate a deterministic 16:10 video-cover poster from a paper directory. Extracts paper metadata and figures and atomically produces poster.tex, poster.pdf, and poster.png. Use for paper-video covers, not conference posters.

Peytontalismanic424/paper-share-skills

Convert a PDF (especially academic papers) to clean Markdown using MinerU — preserves reading order, LaTeX equations, tables, and figures, and runs on the GPU. Use when the user asks to convert/extract a PDF to markdown/text. Invoke directly — no need for the user to type the skill name.

Peytontalismanic424/paper-share-skills

Fix for undefined \setsource/\setdomains/\setpresenter/\setvenue commands when compiling SUSTech Beamer slides from the standard template. Copy the extended beamerthemesustech.sty from the sustech-slides-template repository.

Habilidades Relacionadas