← Todos os artigos

Configuração

Skills e hooks do Claude Code que se pagam sozinhos em tokens

Toda skill que você instala é uma pequena assinatura que você paga em contexto, em toda sessão, dispare ela ou não. Um hook é uma compra completamente diferente — e é nessa diferença que está a maior parte do dinheiro.

Escrito por Ted Mavera, Product Manager na HarnessUp, a empresa que faz a ferramenta descrita aqui. Os textos deste blog são escritos com ajuda de inteligência artificial e revisados pela equipe antes da publicação.

Uma máquina de cerâmica creme com cinco cartuchos de skill, cada um liberando discos de moeda laranja no próprio tubo de vidro, uma ampulheta de latão ao lado e um cartucho solto à frente.

Por que este artigo existe

Há listas de skills do Claude Code por toda parte agora: as dez melhores, as melhores para frontend, as que vão mudar o seu fluxo de trabalho. O que nenhuma delas diz é que cada item dessas listas é uma compra, paga na mesma moeda do próprio trabalho, e cobrada quer você use naquele dia ou não. A lista ranqueia utilidade. Ninguém ranqueia custo.

Este texto faz a segunda metade. Não porque skills sejam um mau negócio — algumas são o melhor negócio de todo o harness —, mas porque a diferença entre uma skill que se paga e uma que taxa discretamente cada sessão é uma diferença que você pode medir, e quase ninguém mede.

Duas formas de gastar ao adicionar uma skill

Uma skill tem uma definição, e parte dessa definição está no contexto do modelo desde o momento em que a sessão começa, para que o agente saiba que a skill existe e quando recorrer a ela. Essa parte é o custo fixo: pago em toda sessão, em toda conversa, independentemente de a skill algum dia rodar. Quando a skill roda, o corpo dela é carregado e suas instruções moldam os turnos seguintes. Esse é o custo variável.

A metade fixa é a que é ignorada, e ela se acumula da forma menos interessante. Dez skills que parecem minúsculas no fim de uma sessão somam um bloco que é relido em todo turno de toda conversa. É a mesma aritmética de qualquer outro contexto: o que fica no topo da conversa é cobrado de novo e de novo, não uma vez.

Hooks funcionam de outro jeito, e é aqui que as listas erram com mais frequência. Um hook é um comando que o harness executa em um evento — antes de uma chamada de ferramenta, depois de uma edição, quando a sessão para. A maioria dos hooks não adiciona token nenhum: eles adicionam latência e mudam o que acontece depois. Um hook que bloqueia uma escrita inútil, recusa uma leitura repetida ou compila o projeto depois de uma edição custa milissegundos e pode devolver um turno inteiro. Em termos de token, os bons são quase de graça; os ruins são caros não porque leem contexto, mas porque falham, repetem ou disparam em tudo.

Como precificar uma skill antes de mantê-la

Quatro perguntas, nesta ordem. Quanto ela adiciona ao contexto de abertura? Quantos turnos ela adiciona ou remove quando roda? Quanta saída ela produz? E com que frequência ela realmente dispara em uma semana normal?

A quarta pergunta é a que decide a maioria dos casos. Uma skill que dispara duas vezes por mês mas viaja no contexto em toda sessão é uma assinatura de algo que você raramente usa. A mesma skill, se bem escrita, custa uma fração do que economiza nas duas ocasiões em que dispara — mas só se as ocasiões forem reais.

Nosso painel tem uma tela voltada exatamente para isso. O Optimize Harness mostra o custo medido de cada skill, subagente, plugin e servidor, com um interruptor para desligar, e recusa deliberadamente adivinhar: o que não foi medido não ganha número. Sua vizinha, a Rules Auditor, faz o mesmo com as regras no CLAUDE.md, mostrando o custo fixo de cada bloco que é recarregado em cada rodada — e propõe um arquivo mais enxuto sem nunca editá-lo por conta própria. As duas são Pro; o hábito de medir que elas habilitam vale mais do que qualquer ferramenta isolada do catálogo.

Um pequeno livro-razão aberto sobre uma bancada de oficina com duas colunas encabeçadas a lápis, uma lupa apoiada na página esquerda e alguns parafusos de latão espalhados por perto.
Custo fixo em uma página, custo variável na outra. A maioria das listas só lê a da direita.

As categorias que costumam pagar

Coisas que impedem uma releitura. O hábito mais caro em uma sessão de agente é ler o mesmo conteúdo duas vezes. Qualquer coisa que entregue um esqueleto antes do corpo, recuse um trecho que o agente já viu ou mantenha um resumo estável em vez do histórico completo está comprando de volta contexto que, de outra forma, seria reenviado dezenas de vezes. O Read Router devolve o índice de um arquivo de contexto grande na primeira leitura e o texto completo só se for pedido; o Delta Read rastreia quais linhas o agente já viu; o Hot Context fatia o histórico antigo em fragmentos que continuam pesquisáveis em vez de residentes.

Coisas que limitam a saída de ferramentas. Um grep que devolve seiscentas correspondências, uma suíte de testes que imprime novecentas linhas, uma página buscada que chega como quarenta mil caracteres de navegação: tudo isso entra no contexto e fica. O Head Limit corta o resultado gigante de grep por chamada e ensina o agente a pedir o resto; o Smart Cut entrega a primeira página de um arquivo grande com o tamanho total; o Output Diet e o Terminal Guide guardam o começo, o fim e as linhas de erro, com a saída completa deixada no disco.

Coisas que evitam um turno desperdiçado. Um turno é a unidade mais cara do sistema, e o desperdício clássico é o turno gasto descobrindo algo que um compilador já sabia. O First Pass compila depois da edição e empurra o erro para o turno seguinte. O Conduction Write bloqueia a escrita que deixaria o arquivo idêntico. O Way Out, quando uma ferramenta falha, aponta para um exemplo no projeto que resolveu o mesmo problema — só quando há evidência disso.

Coisas que encurtam a resposta. O Response Diet corta o texto de aquecimento antes de ele entrar na conversa, que é o momento mais barato possível para cortá-lo. O No Comment pede ao agente que não comente o óbvio e mede quanto código novo ainda chega comentado, sem tocar nos comentários que já existem.

As categorias que costumam não pagar

Skills que repetem documentação que o modelo já tem. Skills de persona e formatação, a menos que o formato seja um requisito rígido. Três servidores MCP que se sobrepõem, cada um inspecionando o projeto na inicialização. E o caso mais sutil: uma skill genuinamente útil, mas instalada duas vezes, em duas versões, com duas descrições ligeiramente diferentes — o agente agora paga pelas duas e tem de escolher.

Nenhuma dessas é um pecado. São todas compras racionais feitas uma de cada vez, por alguém que não foi mostrado o recibo. O problema não é a skill individual; é que a soma nunca foi precificada.

Uma auditoria de 20 minutos

Liste o que você tem instalado. Abra o Optimize Harness e olhe o custo medido por item, depois desligue tudo o que você não usou nesta semana. Abra o Rules Auditor e leia o custo fixo dos blocos no seu arquivo de contexto — a maioria das pessoas encontra pelo menos um bloco que descreve uma convenção que o projeto abandonou. Rode três sessões normais. Compare o contexto de abertura da primeira sessão com o da quarta.

Um aviso, aprendido da forma difícil: desligue as coisas em lotes de uma, e anote o que você removeu. Uma skill que você desativou pode custar mais em qualidade do que economizou em tokens, e a única forma de saber é perceber a semana em que ela ficou quieta.

O que isto não promete

Um contexto enxuto não é automaticamente um bom contexto. Algumas skills ganham o seu custo fixo evitando três turnos ruins por dia, e cortá-las seria o pior tipo de economia. A medição informa o preço; não informa o valor. Esse julgamento continua com você, que é também a razão pela qual toda ferramenta aqui é reversível com um clique e a camada de medição é gratuita — você deveria poder olhar antes de saltar.

A HarnessUp em si não é uma skill, um hook, um plugin, um servidor MCP ou um proxy. É uma segunda camada local que age pelos hooks oficiais do Claude Code e do Codex e nunca lê seu token ou sua chave. A distinção importa para este artigo: nenhuma das ferramentas acima adiciona uma definição ao seu contexto de abertura do jeito que uma skill faz. Elas trabalham no tráfego, não no prompt.

Precifique o que você instalou. Instale a HarnessUp de graça e veja o custo medido de cada skill, subagente e servidor na sua configuração.

Instalar grátis