New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Bug Hunt

by corosolto in corosolto/client

Investiga e conserta defeito no CS BRASIL / CORO SOLTO com o método que esta base pagou caro para aprender — régua antes do conserto, mutação que prova a régua, figura no tamanho em que ela é…

AGPL-3.0Auto-check passedTesting & QA

Install Bug Hunt

skills CLI
$ npx skills add corosolto/client --skill bug-hunt -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install corosolto/client bug-hunt --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/corosolto/client.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/bug-hunt .claude/skills/bug-hunt && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
bug-hunt
GitHub stars
257
Token cost
~5.7k tokens
SKILL.md length
3,382 words
Files
3 (incl. references)
Skills in repo
20
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Investiga e conserta defeito no CS BRASIL / CORO SOLTO com o método que esta base pagou caro para aprender — régua antes do conserto, mutação que prova a régua, figura no tamanho em que ela é…

  • Works in 9 steps: Régua antes do conserto → Toda correção vem com a mutação que… → Gere a figura e OLHE — no tamanho em que… → …
  • Tasks that involve Quality gates
  • SKILL.md covers Antes de tocar em qualquer coisa, As nove leis, cada uma com o…, O fluxo operacional and O quality gate, e a ordem que…, plus 4 more sections
  • Calls npm, node and git

What it does

Bug Hunt is an agent skill from corosolto/client. Investiga e conserta defeito no CS BRASIL / CORO SOLTO com o método que esta base pagou caro para aprender — régua antes do conserto, mutação que prova a régua, figura no tamanho em que ela é servida, e refutação do palpite óbvio antes de agir nele. Use SEMPRE que alguém reportar que algo está quebrado, errado, sumido, travando, não aparece, não toca, reinicia sozinho, "tá bugado", "não funciona", "voltou a acontecer"; quando for reproduzir, isolar, medir ou consertar um defeito; quando for escrever régua nova…

Its SKILL.md is about 5.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/gabaritos.md` and `references/reguas.md`).

It sits in Testing & QA, covering Quality gates. The repository describes itself as: FPS satírico de navegador: 5 facções brasileiras caricatas, 44 personagens, 5 mapas e 26 armas — rounds e Capture the Flag contra bots, direto na aba, sem instalar nada. Three.js… The licence is AGPL-3.0.

When your agent uses it

  • Tasks that involve Quality gates

Example prompts

  • “tá bugado”
  • “não funciona”
  • “voltou a acontecer”
  • “/bug-hunt”

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Régua antes do conserto
  2. Toda correção vem com a mutação que deixa a régua vermelha
  3. Gere a figura e OLHE — no tamanho em que ela é servida
  4. Refute o palpite óbvio antes de agir nele
  5. O sintoma raramente é o defeito
  6. Falha silenciosa tem assinatura — procure a assinatura
  7. Cuidado com o arnês: o defeito pode ser da medição
  8. O cache-bump
  9. Sistema interconectado se mexe sequencialmente

What it can do on your machine

Read from SKILL.md and the folder at commit 0d37b27. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm
    • node
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • blog.langchain.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Bug Hunt loads about 5.7k tokens when it runs, and up to ~8.4k if it reads all its reference files. Until then it costs about 221 tokens; SKILL.md has 3,382 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~221
When it runs · the whole SKILL.md, loaded when a task matches
~5.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from corosolto/client at commit 0d37b27, republished under its AGPL-3.0 licence (© corosolto). 3,382 words, ~5,729 tokens.

Download SKILL.mdSave it as .claude/skills/bug-hunt/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
bug-hunt
description
Investiga e conserta defeito no CS BRASIL / CORO SOLTO com o método que esta base pagou caro para aprender — régua antes do conserto, mutação que prova a régua, figura no tamanho em que ela é servida, e refutação do palpite óbvio antes de agir nele. Use SEMPRE que alguém reportar que algo está quebrado, errado, sumido, travando, não aparece, não toca, reinicia sozinho, "tá bugado", "não funciona", "voltou a acontecer"; quando for reproduzir, isolar, medir ou consertar um defeito; quando for escrever régua nova para um bug; e quando for abrir, atualizar ou fechar item do `KNOWN-BUGS.md`. Use também quando o quality gate estiver VERDE e a pessoa insistir que está errado — esse caso é o mais importante e o mais mal resolvido. NÃO use para melhorar o que já funciona (isso é a `gauntlet-fps`), nem para feature nova, nem para pergunta conceitual que não mexe no jogo.

Caça ao defeito — CS BRASIL / CORO SOLTO

Serve para agente e para gente. Nada aqui é "reproduza, isole, conserte" — isso todo mundo já sabe e não previne nada. O que está escrito abaixo é o que este repositório aprendeu errando, cada regra com o caso real que a comprou e o ponteiro para conferir.

Se você seguir só uma linha deste arquivo, que seja esta:

O número que prova o defeito vem ANTES do conserto. Sem ele você não sabe se consertou — você sabe que mexeu.

Antes de tocar em qualquer coisa

Leia, nesta ordem, e não pule:

  1. KNOWN-BUGS.md (em ../progress) — o defeito já pode estar lá, com causa raiz, arquivo:linha e o que já foi refutado. O cabeçalho tem o placar real do quality gate, colado de uma execução de verdade.
  2. docs/docs/quality-gates.md — as duas leis da casa e o teste de mutação. É a página mais útil do site. Não repito o conteúdo dela aqui; eu aponto.
  3. AGENTS.md — as regras que valem antes da primeira linha de código, e o roteamento para o resto.
  4. tools/eval/ARCH.md — rode npm run arch antes de ler, ou você lê o índice de ontem. É de lá que sai a tabela de conflito: quem pode editar qual faixa de game.js.

A entrada do KNOWN-BUGS.md pode estar velha, e estava. Em 05/08, seguindo esta skill, três defeitos listados como abertos já estavam consertados no código, com régua e tudo: BUG-01 (a guarda de modo mora em public/js/game.js:4358, _hideCtfHud em :4337, o dispose() chama em :6411, e existe tools/eval/ctfhud-check.mjs no check:fast), BUG-03 (public/js/game.js:5625-5639) e BUG-04 (public/js/game.js:12 importa o ViewModelRig; ele é instanciado em :1881). Confira o código antes de "consertar" o que já está consertado — e atualize a entrada quando descobrir isso.

As nove leis, cada uma com o caso que a comprou

1 · Régua antes do conserto

Escreva a medição primeiro, veja ela ficar vermelha, só então mexa no código. Sem o número de antes você não tem A/B, e sem A/B a correção é fé.

Caso real. BUG-21, o ônibus da Brasília. A primeira rodada mediu bem e consertou: parede fantasma de 2,33 m → 0,68 m. Foi reprovada assim mesmo — "devia ser possível andar". Só com a régua andando (tools/eval/obb-check.mjs, grade de 5 cm chamando o _collide de produção) o número virou 0,000 m. 0,68 m é meio passo, e meio passo se sente.

Corolário que vale mais que a lei: quando o dono diz que está errado e o quality gate está verde, o defeito é do quality gate (AGENTS.md, seção "O que é este projeto"). Na 3ª rodada do mesmo ônibus o obb-check estava VERDE e ele continuava certo: a régua comparava o colisor com a caixa declarada, e a caixa declarada nascia do Box3 do GLB inteiro, em toda altura — guarda-sol, telhado de barraca e retrovisor contavam como parede na altura do peito. Régua verde não é prova de que ele está enganado; é hipótese de que ela mede a coisa errada.

2 · Toda correção vem com a mutação que deixa a régua vermelha

Régua que não pode falhar não mede nada. Depois de escrever a medição, quebre o código de propósito e exija vermelho. Se ficar verde, a régua é teatro e a correção não está guardada.

Caso real. Um mutante que desfazia inteiramente a correção do enquadramento passava 20/22 VERDE, porque a invariante lia a declaração de uma constante e não o uso. Outros três buracos iguais foram achados depois.

Como se escreve isso aqui: tools/eval/ctfhud-check.mjs:28-31 (a mutação apaga a guarda de modo e o script sai 1 se a mutação passar — a régua denuncia a si mesma) e tools/eval/obb-check.mjs:33-36 (duas mutações nomeadas, --mutante=aabb e --mutante=semry). Anatomia completa e os quatro modos de cegueira já medidos: references/reguas.md.

3 · Gere a figura e OLHE — no tamanho em que ela é servida

Número sem imagem já enganou este projeto quatro vezes. E olhar o asset no tamanho do asset é teatro: o defeito mora no recorte que o usuário recebe.

Caso real, 05/08. As miniaturas de /armas: 23 das 26 tinham mediana de luminância da tinta reprovando (uzi em 7 de 255, 78 % dos pixels indistinguíveis do fundo da página) — tools/eval/weapon-shots.mjs:117. Elas estavam desenhadas. Nenhuma métrica de texto, de build ou de HTTP teria contado: os 26 arquivos respondiam 200.

Mesmo dia, mesmo defeito, outro recorte. A pistola do canarinho no header "não existia". Ela aparecia nos 24 quadros do .webp de 604×240 — mas o .brand-bird (src/layouts/Layout.astro:254-259) serve uma janela reduzida para 60 px de altura, e ali a arma tem ~8 px, preta sobre marrom escuro. A régua que fechou isso mede o recorte servido: tools/eval/header-bird-check.mjs.

4 · Refute o palpite óbvio antes de agir nele

O palpite óbvio é óbvio porque é barato, não porque é certo. Meça-o e publique o resultado negativo — resultado negativo medido vale tanto quanto conserto.

Caso real. BUG-03: o próprio KNOWN-BUGS.md prescrevia "mover a chamada para dentro do if". Foi medido (9 sementes × 4 mapas × 180 s) e piora: 2,6 → 3,8 episódios de bot mudo. O motivo está escrito em public/js/game.js:5625-5639 — a chamada todo frame também é FILA, e atrás do if vira DISPUTA no instante do gatilho. O que separa os casos não é ONDE a chamada mora, é QUEM pode pegar o token.

Segundo caso. As miniaturas pretas: varrer exposição era o caminho natural e não era a causa — eram 3 direcionais e nenhum ambiente. Com IBL: 23/26 → 3/26; com o piso de bounce: 0/26. O modo de falha estava documentado desde antes em public/js/game.js:1457 ("SEM ambiente … metalness 1,0 lê como silhueta preta").

Terceiro caso. BUG-31: ../progress → archive/plans/02-BOTS-E-MODELS.md:285 mandava rodar retarget-glb.mjs nos palhaços. Rodado, medido, no-op: 0,13° de desvio máximo por osso. Gerar 88 GLB para não mudar um vértice teria custado peso morto contra o teto de 250 MB da CrazyGames.

5 · O sintoma raramente é o defeito

O que o usuário descreve é onde ele estava, não onde está o defeito. Traduza o sintoma numa propriedade mensurável antes de procurar culpado.

"o jogo reiniciou sozinho e foi pro menu principal" (cinco vezes) → não havia caminho automático nenhum. O clique era real: o menu de pausa nascia clicável no mesmo frame, com 0,00 % de canvas exposto sob o cursor, e no centro da tela +100 px estava REINICIAR PARTIDA, +150 px SAIR PRO MENU. É o BUG-00.

"não está tocando música no fim do round, pelo menos pro funkeiro" → %2520. O gerador de manifest codificava o caminho e o audio.js/_sample() já fazia encodeURI — duas codificações na mesma string, %20 virava %2520, o Audio falhava em silêncio. Pegou o funkeiro porque 5 das 20 faixas de round dele têm espaço ou acento no nome; quem tinha nome limpo continuou tocando, e o defeito parecia "problema dos funkeiros". A regra que ficou está em tools/gen-audio-manifest.mjs:59-72: quem grava o caminho não codifica, quem monta URL codifica. Um lado só.

"a vida do 1st player volta a 100, não sei porque" → não era bug: era a regeneração fora de combate, funcionando como escrita. O defeito de verdade era ela ser invisível — sem ícone, som, vinheta ou linha nas configurações. Regra que o jogador não percebe é indistinguível de defeito.

6 · Falha silenciosa tem assinatura — procure a assinatura

Quando a correção "não pegou", não repita a execução: procure a evidência de que ela não rodou. Byte idêntico, contagem idêntica, timestamp idêntico.

Caso real, 05/08. O envMap da pistola do header não aplicou, e o sintoma foi bonito: o .webp saiu com exatamente os mesmos 98.064 bytes do arquivo commitado. Nem um pixel. Causa: o PMREMGenerator produz um render target do contexto WebGL que o criou, e a ferramenta criava um WebGLRenderer novo por quadro. Um renderer para a execução inteira → 98.872 bytes.

A outra assinatura clássica desta base é o catch vazio. 88 requisições 404 por partida (8 personagens × 11 clipes) eram engolidas por um catch de glbchars.js: o jogo funcionava e o console mentia. E public/models/anims/ sem manifesto não dá erro — dá T-pose.

7 · Cuidado com o arnês: o defeito pode ser da medição

Antes de acusar a página, o mapa ou o motor, pergunte se o instrumento estava olhando.

Caso real. 4 miniaturas "faltando" no bloco FUZIL DE BATALHA de /armas: o defeito era da captura. Rolar 600 px a cada 40 ms passa longe do IntersectionObserver do Chrome e 17 das 26 imagens nunca chegavam a ser pedidas. Com 300 px / 120 ms e espera por images.every(complete): 0 faltando, e os 26 arquivos respondiam 200 no dist. (git show a88a00a)

Caso estrutural, ainda aberto: BUG-28. No headless não há WebGLRenderer.render(), então ninguém chama scene.updateMatrixWorld() — e 92 dos 92 occluders do piscina_treta ficam com a matriz na identidade. Toda métrica de bot que dependa de linha de visão no headless está medida contra geometria empilhada na origem. No navegador isso nunca aparece.

E botsim ... all compartilha o cursor do Math.random entre mapas pelo cache preguiçoso de texturas: um mapa que não foi tocado se moveu 0,2. Comparação de botsim all só vale como sequência inteira.

8 · O cache-bump

Mexeu em public/js/**/*.js? O moduleCacheManifest() precisa incluir o módulo publicado: ele deriva a revisão dos bytes e o import map anexa ?v=<versão>-<hash> ao grafo inteiro. Não faça bump manual nem anuncie bancadas removidas por prune-dist.mjs. Rode npm run eval:shaderbudget; SB7 prova cobertura, mudança de conteúdo e fronteira de publicação.

Caso real. Um bump com a mensagem "40 commits não chegavam ao navegador", e mais três no mesmo dia 04/08. Reproduza a frequência: git log --format='%h %ad %s' --date=format:'%d/%m %H:%M' -- public/js/version.js

Na tela de seleção o mesmo laço mordeu de novo: o clamp já estava na árvore e o ?v= não tinha subido — o defeito "não consertou" era o arquivo velho sendo servido. O manifesto por conteúdo substituiu esse processo manual; BUG-48 acrescentou a fronteira do que é publicado.

Isto tem primo: o Chrome ignora ?v= no banco de favicons. Se o ícone não muda, é aba anônima ou limpar dados do site, não é arquivo para mexer.

9 · Sistema interconectado se mexe sequencialmente

Arma + mão + animação + ADS + mira + HUD são um sistema. Fan-out paralelo nele já produziu 13 regressões numa única rodada (CONTRIBUTING.md, "Regras de código"). Um agente, uma frente, em ordem.

Fora desse sistema o paralelismo é seguro e medido, desde que as frentes tenham faixas disjuntas — e a partição se declara por símbolo, nunca por linha (npm run arch).

Show full SKILL.md (1,664 more words)Show less

O fluxo operacional

Oito passos. O 2 e o 5 são os que separam conserto de mexida.

0 · Registre antes de investigar. Abra a entrada no KNOWN-BUGS.md (em ../progress) com as palavras literais de quem reportou. A palavra dele é o dado; a sua paráfrase já é interpretação. Sem evidência ainda, a entrada nasce em Relatados, ainda não reproduzidos, com Régua: nenhuma.

1 · Reproduza, e diga em que instrumento. Navegador (tools/eval/crash-watch.mjs), motor em node (tools/eval/harness.mjs), ou nenhum dos dois — e nesse caso diga que não reproduziu.

2 · Meça: o número que prova o defeito. Escreva a régua antes do conserto e veja o vermelho. Se não existe régua, ela é o primeiro entregável. Formato: references/reguas.md.

2b · Se a medição de ANTES vier VERDE, pare — você tem outro defeito. Isto acontece muito e não é motivo para forçar um conserto. São três casos, e cada um tem saída própria:

  • A entrada está velha e o defeito já foi consertado. Confira o código, feche a entrada com ~~tachado~~ · RESOLVIDO dd/mm e o arquivo:linha da correção. Em 05/08, três entradas listadas como abertas estavam nesse estado.

  • O defeito é LATENTE: existe no código e não tem efeito no dado de hoje. Não escreva régua que passa verde antes e depois — ela não mede nada (lei 2). Reclassifique de "o jogador vê" para latente, e escreva a régua de modo que a mutação forneça a condição que falta (o mapa, o arquivo, a resolução que hoje não existe).

    Caso real, 05/08, e ele tem um segundo tempo que é a lição de verdade. BUG-06: o alvo de capturas do CTF era constante em vez de derivar do número de bandeiras. A medição de antes, construindo cada mapa pelo tools/eval/harness.mjs e contando ctfPoints: os 3 mapas com ctfMode têm 4 bandeiras cada, e a correção prescrita na entrada (Math.floor(n / 2) + 1) dá exatamente o mesmo 3 que já estava lá. Conclusão registrada: defeito latente, régua ficaria verde dos dois lados.

    Estava errado — e a aritmética não era o problema. O dono jogou e disse: "na loja H está com 3 capturas quando a vitória tem que ser as 4. tem que ser todas sempre." O que a medição tinha refutado era a regra proposta na entrada, não o defeito. Com a regra certa (capsToWin = ctfPts.length, public/js/game.js:4067) o defeito é imediato, visível e mensurável: a rodada fechava na 3ª de 4 bandeiras. Régua nova: tools/eval/ctf-win-check.mjs, com --mutante=constante reproduzindo o que ele viu.

    A moral, e é a mais cara desta seção: "a régua de antes veio verde" tem uma quarta saída que a lista acima não cobria — a regra que você ia codificar pode ser a errada. Antes de carimbar "latente", confira a regra com quem define o comportamento. Verde pode ser resposta certa para a pergunta errada.

  • A régua está medindo a coisa errada. É o corolário da lei 1. Se alguém insiste que está errado, essa é a hipótese mais provável — não a de que ele se enganou.

  • A REGRA que você ia codificar é a errada. A conta fecha e mesmo assim o comportamento está errado, porque o critério nunca foi o certo. É o caso do BUG-06, logo acima.

3 · Refute o palpite óbvio. Meça-o e escreva o resultado negativo na entrada. É o passo que mais economiza tempo e o mais pulado.

4 · Conserte na causa, não no sintoma. O antes/depois e a causa raiz ficam na entrada do KNOWN-BUGS.md. No código, prefira nomes claros; se uma invariante não couber neles, use no máximo duas linhas e aponte para a entrada, sem copiar a investigação.

5 · Mute a régua. Reintroduza o defeito e exija vermelho na cláusula certa. Sem isso o passo 2 não vale.

6 · Rode o quality gate, na ordem. Detalhe abaixo.

7 · Feche a entrada com o antes × depois medido, o nome da régua nova, o comando que a roda, e as mutações com o número de cada uma. E anote o custo declarado: o que piorou junto.

8 · Reporte, inclusive o que você NÃO verificou. Gabaritos: references/gabaritos.md.

O quality gate, e a ordem que importa

bash
npm run check:fast   # segundos — rode este primeiro, sempre
npm run build        # o site tem que buildar
npm run check:seo    # se mexeu em src/ ou em public/llms.txt

A composição exata sai do package.json (o porquê de cada passo mora no SCRIPTS.md (em ../progress)) e está publicada como bloco gerado em AGENTS.md. Não copie a lista para lugar nenhum — ela muda.

Três armadilhas de quality gate, todas já pagas:

  • eval:vm roda ANTES de eval:invariants. As invariantes de viewmodel leem um JSON que o eval:vm gera. Com o JSON congelado, VM5 acusava 26/26 armas fora; regenerado, 3/26. O check:fast já está na ordem certa — o cuidado é para quando você chamar node tools/eval/invariants.mjs à mão. É o BUG-02.
  • Placar vermelho por dívida conhecida mascara passo novo vermelho. O runner percorre todos os passos mesmo com vermelho no meio e decide o código de saída só no fim — o que significa que, com um vermelho conhecido na cadeia, um passo que quebrou agora não muda o sinal: é preciso ler o placar passo a passo. Caso real de 05/08: com o anims:check vermelho no meio da corrente (BUG-15, public/models/anims/ não versionado), sete quality gates atrás dele rodavam zero vezes na época do &&. Leia a entrada check:fast do SCRIPTS.md antes de acrescentar um passo.
  • Vermelho que não corresponde a defeito ensina a ignorar vermelho. Se uma régua fica vermelha por edição de prosa ou por commit, o defeito é dela.

E o veto do dono: não afrouxe teto de invariante para fechar placar. Se achar que um teto está errado, meça na referência e mostre o pixel.

Sessões longas: sanduíche de raciocínio e detector de loop

Dois padrões que esta base já praticava informalmente e agora nomeia — a fonte é o caso da LangChain em que mudanças só de harness tiraram um agente do rank 30 para o top 5 sem trocar o modelo (write-up).

Sanduíche de raciocínio. Delibere fundo em dois pontos, e só neles: o planejamento (antes de tocar no código — qual régua, qual hipótese, qual faixa do game.js) e a verificação (antes de declarar pronto — mutação vermelha, figura olhada, o que não foi verificado). No meio, execute enxuto. Quem delibera no meio da execução é o drive-by refactor. Esta skill já é o sanduíche: os passos 0-3 são o planejamento, os 5-8 são a verificação; o nome existe para você perceber quando saiu dele.

Detector de loop. Se a mesma ação falhou três vezes com a mesma assinatura — mesmo erro, mesma saída, mesmo vermelho — você não está investigando, está girando. Pare e mude de estratégia: troque de instrumento (navegador ↔ harness em node), suba um nível de abstração, ou escale para o dono com o que você já mediu. A lei 6 é o antídoto: quem procura a assinatura da falha não repete a execução que já falhou.

Números: um lugar só, e gerado

Número derivável do código não se escreve à mão em nenhum arquivo deste repositório — vira bloco gerado por node tools/gen-docs.mjs, e npm run docs:check (dentro do check:fast) reprova quando diverge.

Caso real, e é por isso que este arquivo tem tão pouco número: o SKILL.md da gauntlet-fps afirmava que o game.js tinha 3.234 linhas quando o arquivo já tinha 6.427 (tools/gen-docs.mjs:5-10). Corrigir 3.234 para 6.427 dura até o próximo commit.

Para consultar sem escrever: node tools/gen-docs.mjs --json imprime todos os fatos medidos, cada um com o comando que o reproduz.

A distinção que resolve a dúvida na hora de escrever:

TipoExemploO que fazer
Número de estado (o repo tem N disso hoje)linhas de game.js, quantidade de armas, mapas, personagens, invariantesbloco gerado, ou aponte para onde ele já é gerado
Número de evento (isto foi medido nesta execução, nesta data)"2,33 m → 0,68 m", "98.064 bytes", "23 das 26 daquela rodada"escreva, com data e com o comando que reproduz
Placar do quality gatequantas invariantes passamnão é derivável: depende de qual insumo existe na máquina. Vive colado no cabeçalho do KNOWN-BUGS.md, de execução real

Duas coisas que este arquivo não tem, e é melhor você saber: ele não recebe bloco gerado (a tabela COLOCACAO de tools/gen-docs.mjs declara em quais arquivos cada bloco aparece, e não inclui este), e ele não entra na varredura de ponteiros do mesmo script, que hoje cobre README/AGENTS/docs/docs e só o SKILL.md da gauntlet-fps (tools/gen-docs.mjs:584-586). Consequência prática: aqui número de estado não se escreve — aponta-se; e os arquivo:linha desta skill são conferidos à mão. Se você mexer no COLOCACAO ou nessa lista, inclua este arquivo nos dois.

Armadilhas específicas desta base

ArmadilhaO que acontece
Servir public/ estático para testarVocê recebe os arnêses visuais, não o jogo. O jogo é a rota /, e o HTML dele é src/pages/index.astro.
Adicionar dependência ou passo de build em public/Quebra o tools/eval/harness.mjs, que sobe a classe Game real em node puro — é ele que faz o quality gate existir.
Validar enquadramento de arma só em 16:9O dono joga em 3:2. Já custou uma rodada inteira.
// em CSSNão é comentário. O parser engole o bloco seguinte — já matou um @keyframes inteiro.
Duas capturas headless em paraleloDerruba o boot e falsifica a medição. Um agente só roda browser.
Rodar reskin-glb.mjs de novo "porque é inócuo"Não é idempotente: repintar com os mesmos parâmetros piorou o padati em 12 %.
Régua que passa por vacuidadeSem inventário declarado, apagar o alvo deixa a régua verde sem medir nada — tools/eval/obb-check.mjs:28-31.
Percentil alto em defeito pequenoDefeito que mora acima do P97 é invisível para um P95 por construção — tools/eval/select-inflate.mjs:20-25.
Comparar botsim all item a itemOs mapas compartilham o cursor de Math.random. Só vale como sequência inteira.

Referências

  • references/reguas.md — anatomia de uma régua desta casa, os quatro modos de cegueira já medidos, e o esqueleto com mutação.
  • references/gabaritos.md — gabarito da entrada do KNOWN-BUGS.md e do relatório final, incluindo como declarar o que não foi verificado.
  • docs/docs/quality-gates.md — as duas leis, a procedência de teto e o teste de mutação.
  • KNOWN-BUGS.md (em ../progress) · AGENTS.md · CONTRIBUTING.md.
  • gauntlet-fps — a skill irmã. Ela melhora o que funciona; esta conserta o que está quebrado. Se o pedido é "deixe melhor", é lá.

© corosolto, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in .claude/skills/bug-hunt of corosolto/client.

  • SKILL.md
  • references/gabaritos.md
  • references/reguas.md

Open the folder on GitHubat commit 0d37b27

Compare with similar skills

Bug Hunt next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Bug Hunt compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bug Hunt this skillcorosolto/client257—~5.7kAutomated safety check: PassAGPL-3.0
Feature Plannerserendipity1004/cc-feature-implementer176—~2.4kAutomated safety check: PassNone
Ccg Workflowfengshao1227/ccg-workflow5.9k—~2.3kAutomated safety check: PassMIT
Conducty Checkpointrobertbarclayy/conducty176—~1.5kAutomated safety check: PassMIT
Mission Plannerjdforsythe/forge151—~3.5kAutomated safety check: PassMIT
Quality Gate0xNyk/lacp305—~382Automated safety check: PassMIT

Similar skills

  • Feature Planner

    serendipity1004/cc-feature-implementer

    Creates phase-based feature plans with quality gates and incremental delivery structure.

    176 GitHub stars~2.4k tokensUpdated 9 mo ago
    Testing & QAAuto-check passed

  • Ccg Workflow

    fengshao1227/ccg-workflow

    How to run a non-trivial change end to end with the CCG role tools (ccganalyze / ccgdesign / ccgbuild / ccgdebug / ccgoptimize / ccgreview / ccgtest) and the verify- quality gates.

    5.9k GitHub stars~2.3k tokensUpdated 23 days ago
    Testing & QAAuto-check passed

  • Conducty Checkpoint

    robertbarclayy/conducty

    Quality gate between parallelization groups. An agent skill from robertbarclayy/conducty.

    176 GitHub stars~1.5k tokensUpdated 3 mo ago
    Testing & QAAuto-check passed

  • Mission Planner

    jdforsythe/forge

    Decomposes goals into team blueprints using evidence-based scaling laws, topology selection, and role design.

    151 GitHub stars~3.5k tokensUpdated 3 mo ago
    Testing & QAAuto-check passed

  • Quality Gate

    0xNyk/lacp

    Production quality gate for agent sessions. An agent skill from 0xNyk/lacp.

    305 GitHub stars~382 tokensUpdated 16 days ago
    Testing & QAAuto-check passed

  • Deploy Workflow

    nwiizo/ccswarm

    Release deployment process for ccswarm. An agent skill from nwiizo/ccswarm.

    153 GitHub stars~582 tokensUpdated 24 days ago
    Testing & QAAuto-check passed

More from corosolto/client

All 20 skills in this repo

  • Threejs Gameplay Systems

    corosolto/client

    Build and iterate playable Three.js game systems. An agent skill from corosolto/client.

    257 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed

  • Threejs Gltf Loading

    corosolto/client

    Load glTF/GLB models in three.js with GLTFLoader and play their skinned animations with AnimationMixer, including DRACO/Meshopt-compressed meshes and KTX2 textures.

    257 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed

  • Threejs 3D Generator

    corosolto/client

    Generate, texture, rig, animate, stylize, convert, and download 3D assets for Three.js games using the Tripo API.

    257 GitHub stars~3.4k tokensUpdated yesterday
    Auto-check passed

  • Threejs Materials Lighting

    corosolto/client

    Light and shade a three.js scene: choose materials (MeshStandardMaterial PBR vs unlit MeshBasicMaterial), add ambient/hemisphere/directional/point/spot lights, turn on shadow maps, and use an…

    257 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed

  • Threejs Scene Setup

    corosolto/client

    Stand up a three.js scene: import maps and the three/addons path, the Scene/PerspectiveCamera/WebGLRenderer trio, the setAnimationLoop render loop, responsive resize, and OrbitControls.

    257 GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed

  • Threejs Game Director

    corosolto/client

    Primary entrypoint for complete Three.js browser game creation and premium iteration.

    257 GitHub stars~2.8k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Bug Hunt

What does Bug Hunt do?

Investiga e conserta defeito no CS BRASIL / CORO SOLTO com o método que esta base pagou caro para aprender — régua antes do conserto, mutação que prova a régua, figura no tamanho em que ela é…. Bug Hunt is an agent skill from corosolto/client. Investiga e conserta defeito no CS BRASIL / CORO SOLTO com o método que esta base pagou caro para aprender — régua antes do conserto, mutação que prova a régua, figura no tamanho em que ela é servida, e refutação do palpite óbvio antes de agir nele.

When should I use Bug Hunt?

Bug Hunt fits situations like: tasks that involve Quality gates.

How do I install Bug Hunt in Claude Code?

Run `npx skills add corosolto/client --skill bug-hunt -a claude-code`. Or copy the skill folder (.claude/skills/bug-hunt in corosolto/client) into .claude/skills/bug-hunt in your project. Claude Code loads it when a task matches its description.

How do I install Bug Hunt in Codex?

Run `npx skills add corosolto/client --skill bug-hunt -a codex`. Or copy the skill folder (.claude/skills/bug-hunt in corosolto/client) into .agents/skills/bug-hunt in your project. Codex loads it when a task matches its description.

Can I use Bug Hunt in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add corosolto/client --skill bug-hunt -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bug-hunt, .gemini/skills/bug-hunt, .github/skills/bug-hunt and .opencode/skills/bug-hunt in your project.

What does Bug Hunt need to run?

Going by SKILL.md and its folder, Bug Hunt needs the command-line tools its instructions call (npm, node and git).

Does Bug Hunt access the network?

SKILL.md names 1 domain. As links in the text: blog.langchain.com. This is read from the text; nothing was executed.

Is Bug Hunt safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Bug Hunt use?

Bug Hunt is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Bug Hunt use?

About 5.7k tokens (SKILL.md is roughly 23k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.7k tokens, read only when the agent opens those files.

What are the alternatives to Bug Hunt?

Skills that share tags, products or a category with Bug Hunt: Feature Planner (serendipity1004/cc-feature-implementer, 176 stars), Ccg Workflow (fengshao1227/ccg-workflow, 5.9k stars), Conducty Checkpoint (robertbarclayy/conducty, 176 stars) and Mission Planner (jdforsythe/forge, 151 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bug Hunt?

corosolto (a GitHub organization) maintains it in corosolto/client, which has 257 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on October 7, 2026.

Source: corosolto/client on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.