Skip to content

INSTALACAO.md

Latest commit

 

History

History
252 lines (169 loc) · 6.27 KB

INSTALACAO.md

File metadata and controls

252 lines (169 loc) · 6.27 KB
Raw

Instalação — pesquisador-br-skill

Guia detalhado pra instalar a skill no Claude Code.

Pré-requisitos

  • Claude Code instalado e configurado
  • Git instalado
  • Python 3.9+ (apenas se for usar os scripts utilitários)

Método 1: via plugin marketplace (recomendado)

Passo 1: Adicionar marketplace

No Claude Code, execute:

/plugin marketplace add https://github.com/DevAlissu/pesquisador-br-skill

Passo 2: Instalar plugin

/plugin install pesquisador-br-skill

Passo 3: Reiniciar Claude Code

Saia do Claude Code e abra novamente. As skills serão detectadas automaticamente.

Passo 4: Verificar instalação

Faça uma pergunta que ative a skill:

Como faço a estrutura de um TCC ABNT?

Se a skill pesquisador-br for invocada (você verá a notificação), está funcionando.

Método 2: instalação manual (avançado)

Passo 1: Clonar repositório

git clone https://github.com/DevAlissu/pesquisador-br-skill.git
cd pesquisador-br-skill

Passo 2: Copiar skills pra Claude Code

Linux / macOS

mkdir -p ~/.claude/skills
cp -r skills/* ~/.claude/skills/

Windows (PowerShell)

$claudeSkills = "$env:USERPROFILE\.claude\skills"
New-Item -ItemType Directory -Force -Path $claudeSkills
Copy-Item -Path .\skills\* -Destination $claudeSkills -Recurse

Windows (Git Bash)

mkdir -p ~/.claude/skills
cp -r skills/* ~/.claude/skills/

Passo 3: Reiniciar Claude Code

Saia e abra novamente.

Método 3: link simbólico (pra desenvolvimento)

Se você quer editar a skill e ver mudanças instantâneas (sem copiar a cada vez):

# Linux/macOS
ln -s "$(pwd)/skills/pesquisador-br" ~/.claude/skills/pesquisador-br
ln -s "$(pwd)/skills/revisao-sistematica-br" ~/.claude/skills/revisao-sistematica-br
ln -s "$(pwd)/skills/revisor-pares-br" ~/.claude/skills/revisor-pares-br
ln -s "$(pwd)/skills/tcc-abnt" ~/.claude/skills/tcc-abnt

# Windows (PowerShell, requer admin)
New-Item -ItemType SymbolicLink -Path "$env:USERPROFILE\.claude\skills\pesquisador-br" -Target "$(pwd)\skills\pesquisador-br"

Agora qualquer mudança no diretório do projeto reflete na skill instalada.

Configuração adicional

Variáveis de ambiente

A skill não exige variáveis de ambiente pra funcionar — todos os scripts usam APIs públicas sem autenticação:

  • SciELO: API pública, sem key
  • CrossRef: API pública, sem key (User-Agent já configurado no script)
  • BDTD/IBICT: acesso direto via web

Periódicos CAPES usa autenticação federada (CAFe/Shibboleth com SAML), não token. O acesso é feito pelo navegador do usuário no portal oficial — nenhuma integração programática direta é possível sem credencial institucional.

Sucupira (Qualis CAPES): não tem API pública. Consulta manual via web (o script verifica_qualis.py apenas guia o usuário).

Se quiser usar a skill com Claude API direto (fora do Claude Code), aí sim precisa de ANTHROPIC_API_KEY — mas isso é uso avançado, não requisito.

Scripts Python

Pra usar os scripts utilitários:

# Verificar Python instalado
python --version  # ou python3 --version

# SciELO via ArticleMeta API (por ISSN)
python scripts/busca_scielo.py 0102-311X --max 10

# DOI -> referência ABNT (CrossRef)
python scripts/doi_para_referencia.py 10.1590/S1413-24782020000100008

# Buscar teses via OAI-PMH (UFRGS Lume por padrão)
python scripts/busca_bdtd.py "ensino híbrido"
python scripts/busca_bdtd.py --endpoints              # listar repositórios
python scripts/busca_bdtd.py --sets                   # listar coleções

# Validar formato ABNT 6023 num arquivo de referências
python scripts/valida_referencias.py referencias.txt
python scripts/valida_referencias.py --teste          # auto-teste

# Guia de consulta Qualis (Sucupira não tem API)
python scripts/verifica_qualis.py

Não há dependências externas — todos os scripts usam apenas stdlib e endpoints públicos.

Troubleshooting

Skill não é detectada

Causa: arquivo SKILL.md não está em ~/.claude/skills/<nome>/SKILL.md.

Solução:

ls ~/.claude/skills/
# Deve mostrar: pesquisador-br/, revisao-sistematica-br/, ...

cat ~/.claude/skills/pesquisador-br/SKILL.md | head -10
# Deve mostrar o frontmatter com 'name' e 'description'

Triggers não ativam a skill

Causa: o usuário não usou termos do triggers no SKILL.md.

Solução: tente com palavras-chave mais explícitas:

  • "Me ajude com normas ABNT"
  • "Preciso fazer um TCC"
  • "Como estruturar dissertação de mestrado?"

Ou peça explicitamente pra invocar:

Use a skill pesquisador-br pra me ajudar com [tema]

Plugin não instala (marketplace)

Causa: URL do repositório errada ou marketplace não configurado.

Solução:

# Listar marketplaces configurados
/plugin marketplace list

# Remover e adicionar de novo
/plugin marketplace remove pesquisador-br-skill
/plugin marketplace add https://github.com/DevAlissu/pesquisador-br-skill

Skill carregada mas comportamento estranho

Causa: Claude Code em cache antigo ou versão desatualizada.

Solução:

# Verificar versão Claude Code
claude --version

# Limpar cache (caminho varia por SO)
# Linux/macOS: ~/.cache/claude/
# Windows: %LOCALAPPDATA%\claude\Cache\

# Reiniciar Claude Code

Atualização

Atualizar via plugin

/plugin update pesquisador-br-skill

Atualizar via git pull

cd /caminho/para/pesquisador-br-skill
git pull origin master
cp -r skills/* ~/.claude/skills/  # Se for instalação manual

Desinstalação

Via plugin

/plugin uninstall pesquisador-br-skill

Manual

rm -rf ~/.claude/skills/pesquisador-br
rm -rf ~/.claude/skills/revisao-sistematica-br
rm -rf ~/.claude/skills/revisor-pares-br
rm -rf ~/.claude/skills/tcc-abnt

Próximos passos

  1. Leia docs/USO.md pra ver exemplos de uso
  2. Leia docs/ARQUITETURA.md pra entender a estrutura
  3. Conheça as referências de ABNT em skills/pesquisador-br/references/abnt/
  4. Experimente os scripts em scripts/

Bem-vindo à pesquisa acadêmica brasileira no Claude Code 🇧🇷