Communitygithub.com

shimo4228/claude-skill-paper-ecosystem

Skill do Claude Code Agent para escrever e revisar artigos acadêmicos (SSRN / arXiv / Zenodo / periódicos). Inclui um skill orquestrador, um skill de rascunho e 5 subagentes revisores — primeiro repositório a empacotar skills + agentes juntos via install.sh.

O que é claude-skill-paper-ecosystem?

Este skill, chamado `paper-ecosystem`, é um conjunto abrangente para o Claude Code Agent que organiza o fluxo de trabalho de redação e revisão de artigos acadêmicos (position papers, preprints, artigos de periódicos). Ele define regras canônicas para garantir fidelidade às fontes primárias, consistência de vocabulário, tom acadêmico e formatação de citações. O skill ativa quando o usuário inicia um rascunho para venues como SSRN, arXiv, Zenodo ou periódicos, e é desativado para postagens informais de blog ou documentos para IA. O destaque principal é um processo rigoroso de pré-rascunho que inclui: estabelecer uma lista de fontes primárias (evitando dependência de resumos secundários), mapear cada afirmação central para uma fonte de citação em relação 1:1, e preservar sub-classificações encontradas nas fontes. O rascunho segue uma estrutura padrão de 9 seções e um resumo de 3 parágrafos, com revisão paralela por agentes especializados (revisor, verificador de fidelidade de fontes, verificador de consistência de vocabulário). Antes do depósito, uma lista de verificação de qualidade garante que todas as revisões foram aprovadas e que não há desvios. O skill também suporta uma convenção multilíngue opcional onde o inglês é a versão primária e as traduções são mantidas como secundárias.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add shimo4228/claude-skill-paper-ecosystem

Perguntar na sua IA favorita

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

Documentação

paper-writing — Procedimento de rascunho de artigo acadêmico

Skill para organizar o procedimento de rascunho de position paper / preprint / artigo de periódico de acordo com as regras oficiais do orquestrador paper-ecosystem.

Quando Ativar

  • Redigir um paper para venues SSRN / arXiv / Zenodo / periódico
  • Extrair um paper de uma série existente de ensaios / ADRs / histórico de implementação
  • Após a definição do esboço de um position paper, iniciar a redação de cada seção
  • Revisão de preprint v1 → v2 (quando envolver reescrita significativa)

Fora da Ativação

  • Post de blog / ensaio (humano primário, informal) → usar writing-ecosystem
  • llms.txt / FAQ (IA primário) → usar llms-txt-writer
  • README / CHANGELOG (documentação de projeto) → escrever diretamente sem skill

Lista de Verificação Pré-rascunho

Antes de iniciar o rascunho do paper, o autor deve concluir:

1. Estabelecer a lista de fontes primárias

Listar as fontes primárias que o paper citará:

  • Ensaios / posts de blog citados (URL + data + resumo de 1 linha)
  • ADRs / documentos de especificação citados (caminho do repositório + versão + resumo de 1 linha)
  • Artigos externos citados (Autor ANO + arXiv ID / DOI + resumo de 1 linha)
  • Padrões / documentos de framework citados (Org ANO + ID do padrão)

Cada fonte primária deve estar disponível para leitura direta durante o rascunho do paper (acesso via URL, repositório clonado, PDF obtido).

2. Evitar dependência de glossário / resumo

Não usar glossário / resumo do repositório ou documento secundário como fonte de citação em vez da fonte primária. O desvio do secundário se propaga para o paper (detalhes: regras de Fidelidade de Fontes do skill paper-ecosystem).

O secundário só deve ser consultado para:

  • Verificar consistência de definição de termos (se a definição do paper coincide com a definição do glossário)
  • Referência de formato da lista de referências (exemplo de estilo com quais campos incluir)

3. Mapeamento 1:1 entre Afirmação e Fonte Citada

Na fase de esboço, escreva a afirmação central de cada seção em uma frase e mapeie cada afirmação para sua fonte citada correspondente em relação 1:1. Afirmações com mapeamento ambíguo devem ser resolvidas antes de entrar no rascunho.

Exemplo de formato:

§3 afirmação central: "A falha de redirecionamento tem dois modos arquitetonicamente distintos — o principiado (intrínseco a loops autônomos) e o artificial (trabalho de fluxo roteado através de loops autônomos)."
Fontes citadas:
- Ensaio 5 (zenn-content/articles-en/react-agent-business-quadrant-2.md, 2026-04-30)
- ADR-0009 §Contexto (agent-attribution-practice/docs/adr/0009-triage-before-autonomy.md)
- Elish (2019) "Moral Crumple Zones"

4. Preservar sub-classificações

Se a fonte primária atribui sub-formas / sub-células / sub-tipos a um conceito, isso deve ser explicitado na introdução do termo no paper. A simplificação (achatamento) causa desvio (detalhes: regras de Consistência de Vocabulário do skill paper-ecosystem).


Modelo de Seção (position paper / preprint)

Estrutura padrão de 9 seções:

  1. Página de título — Título + subtítulo + autor + ORCID + versão + repositório complementar + licença
  2. Resumo — 250-300 palavras, estrutura de 3 parágrafos (abaixo)
  3. Introdução — Declaração do problema + prévia da tese + roteiro das seções
  4. [Seções do corpo] — Contribuição central do paper. Cerca de 3-6 seções
  5. Relação com frameworks existentes — Breve (1 parágrafo a 1 página), relação com frameworks concorrentes
  6. Conclusão — Retomada da tese + perguntas em aberto
  7. Referências — Simplificado no estilo APA
  8. Agradecimentos (opcional)
  9. Apêndice (opcional)

Para artigos de periódico, ajuste a numeração das seções / hierarquia de cabeçalhos / disposição de tabelas e figuras de acordo com o estilo da casa do veículo.


Estrutura do Resumo (250-300 palavras)

3 parágrafos:

  1. Declaração do problema (~70-90 palavras) — Qual fenômeno é abordado e o que falta no discurso atual
  2. Contribuições (~120-150 palavras) — 2-3 contribuições centrais do paper, cada uma com uma frase sobre o quê / por quê / como
  3. Consequência (~60-90 palavras) — O que a contribuição proporciona ao público do paper, menção a perguntas em aberto não resolvidas

Palavras-chave (5-8) colocadas imediatamente abaixo do resumo.


Formato das Referências (simplificado no estilo APA)

Tipo de fonteFormato
Artigo de periódicoAutor, A. B. (ANO). Título. *Nome do Periódico* Vol(Número): páginas.
Preprint arXivAutor, A. B., & Autor, C. D. (ANO). *Título.* arXiv:NNNN.NNNNN.
Artigo de conferênciaAutor, A. B. (ANO). Título. In *Título dos Anais* (páginas). Editora.
Documento de indústria / empresaOrg. (ANO). *Título.* URL
PadrãoOrg. (ANO). *ID do Padrão Título.* Editora.
Repositório / conjunto de dadosAutor, A. B. (ANO). *Título (Versão).* Plataforma. DOI

Detalhes: regras de Formato de Citação do skill paper-ecosystem.


Convenção Multilíngue (opcional)

Se uma versão em idioma subordinado (ex.: tradução para japonês) for criada em paralelo:

  • A versão em inglês é a primária; a versão no idioma subordinado não é a versão oficial
  • Nomenclatura de arquivos: <nome-do-paper>.md (inglês) + <nome-do-paper>.ja.md (japonês)
  • Ao alterar o conteúdo, a versão em inglês vem primeiro; a versão no idioma subordinado é atualizada sequencialmente
  • Termos técnicos (Quadrant / Phase Separation / nome do artefato, etc.) permanecem em inglês ou com inglês anexado na versão subordinada

Detalhes: convenção de Paper Multilíngue do skill paper-ecosystem.


Processo de Redação (rascunho de seção)

Procedimento de rascunho de cada seção:

  1. Escreva a afirmação da seção em uma frase (reverifique a saída da lista de verificação pré-rascunho)
  2. A abertura da seção deve ser concreta: exemplo / fenômeno conhecido / citação da fonte citada; não comece com enquadramento abstrato
  3. Coloque as evidências que sustentam a afirmação imediatamente após (com citação 1:1)
  4. Indique a transição da seção ao final da seção: o que está sendo passado para a próxima seção, o que da seção atual é levado como premissa
  5. Parágrafos subordinados devem ser consistentes em uma direção: seja de decomposição da afirmação ou de tratamento de contraposições / alternativas; misturar ambas enfraquece o fluxo

Após concluir o rascunho de cada seção, inicie em paralelo os agentes paper-reviewer + source-fidelity-checker + vocabulary-consistency-checker para revisão (detalhes: fluxograma "Quando Usar O Quê" do skill paper-ecosystem).


Portão de Qualidade (antes do depósito)

Imediatamente antes do depósito, verifique:

  • Todas as seções passaram pelo paper-reviewer
  • Todas as afirmações têm avaliação ALIGNED ou PARTIAL no source-fidelity-checker (nenhum DRIFT restante)
  • Todos os termos passaram pelo vocabulary-consistency-checker (introdução de sub-classificações explicitada)
  • citation-formatter reporta 0 citações órfãs, citações ↔ referências 1:1
  • Contagem de palavras do resumo está dentro do padrão do veículo
  • DOI / arXiv ID / URL são todos válidos
  • Se houver versão multilíngue, não há divergência de conteúdo com a versão em inglês

Para dimensões detalhadas, consulte as 4 seções de regras canônicas dentro do skill paper-ecosystem.


Relacionados

  • Skill paper-ecosystem — Fidelidade de Fontes / Consistência de Vocabulário / Tom Acadêmico / Formato de Citação — o orquestrador do qual este skill depende
  • Agente paper-reviewer — Revisão estrutural após o rascunho da seção
  • Agente source-fidelity-checker — Verificação de consistência citação-afirmação após o rascunho da seção
  • Agente vocabulary-consistency-checker — Verificação de consistência de termos após o rascunho da seção
  • Agente citation-formatter — Portão final de citações ↔ referências antes do depósito
  • Skill writing-ecosystem — Para post de blog / ensaio, não este skill
  • Skill llms-txt-writer — Para documentação voltada a IA, não este skill

Habilidades Relacionadas