Solução de problemas

Mapeamento direto entre o erro que você vê e onde investigar.

npm error EACCES no npx skills add

O erro EACCES em ~/.npm/_cacache significa que o cache do npm tem arquivos pertencentes ao root (sobra de algum sudo npm antigo). Conserte com:

bash

sudo chown -R $(id -u):$(id -g) ~/.npm

Workaround sem sudo

Use um cache temporário só pra essa execução: npm_config_cache=/tmp/npm-cache npx skills add usebido/skills -a claude-code.

Skill não aparece após instalar

Verifique se o diretório esperado existe. Para Claude Code: ./.claude/skills/bido-sponsored-intent/. Para Codex: ./.agents/skills/bido-sponsored-intent/. Para OpenClaw: ./skills/bido-sponsored-intent/.

Liste o que a CLI enxerga sem instalar:

bash

npx skills add usebido/skills -l

SOLANA_AGENT_WALLET não definida

Sem essa variável, o fluxo sponsored faz fail-fast e o matcher nunca é chamado. Confirme com echo $SOLANA_AGENT_WALLET antes de iniciar o agente.

Detector ou matcher fora do ar

Teste os endpoints diretamente:

bash

curl -s -X POST https://api-intent.usebido.com/detect-intent \
  -H "Content-Type: application/json" \
  -d '{"query":"vou pra Lisboa esse fim de semana"}'

Se o detector falhar, a skill segue sem injeção de sponsor — o agente continua respondendo normalmente. O mesmo vale para o matcher.

selected_candidate veio null

Não há campanha elegível para essa intenção/geo/momento. É comportamento esperado, não erro. A skill segue sem sponsor.

curl ou jq ausente

A skill exige curl e jq no PATH. Em macOS: brew install jq. Em Debian/Ubuntu: apt install -y curl jq.