engguh01/spotter

Uma habilidade de agente de "escopo antes da leitura" (SKILL.md) que localiza arquivos relevantes antes que seu agente de codificação os leia. Como um observador de atirador apontando coordenadas.

O que é spotter?

O Spotter é uma habilidade especializada para agentes de codificação (como Claude Code, Cursor, Codex) que implementa o padrão "escopo antes da leitura". Em vez de um agente ler cegamente todos os arquivos de um projeto, o Spotter primeiro identifica e localiza os arquivos mais relevantes para a tarefa em questão, agindo como um "observador" (spotter) que aponta para os alvos certos. Isso é útil para grandes bases de código onde a leitura completa é lenta e cara (em termos de tokens de contexto). A habilidade funciona analisando o diretório do projeto (via comandos como `find`, `grep`, `ls`, `tree`), filtrando arquivos com base em padrões de nomes, extensões, conteúdo ou histórico do git, e então fornecendo esses caminhos ao agente para leitura focada. Isso reduz o ruído, acelera o processamento e melhora a precisão das respostas do agente. A habilidade é definida em um arquivo SKILL.md e é ativada por prompts ou gatilhos específicos, sendo compatível com qualquer plataforma que suporte o formato SKILL.md.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add engguh01/spotter

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

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

Documentação

O que spotter faz?

Uma habilidade de agente de "escopo antes da leitura" (SKILL.md) que localiza arquivos relevantes antes que seu agente de codificação os leia. Como um observador de atirador apontando coordenadas.

Visão Geral

O Spotter implementa o padrão escopo antes da leitura para agentes de codificação. Ele ajuda a:

  • Reduzir o consumo de tokens lendo apenas arquivos relevantes
  • Acelerar o processamento evitando buscas cegas no diretório
  • Melhorar a precisão fornecendo contexto direcionado

Como Funciona

O Spotter usa comandos como find, grep, tree e git log para entender a estrutura do projeto e identificar os arquivos mais relevantes para a tarefa.

Comportamento Padrão

Ao ser invocado, o Spotter:

  1. Analisa a estrutura do diretório atual
  2. Filtra arquivos por padrões (extensões, nomes, palavras-chave)
  3. Verifica o histórico do git para alterações recentes
  4. Retorna uma lista dos arquivos mais relevantes

Uso

# Ativar o Spotter via prompt
@spotter: encontre todos os arquivos relacionados a autenticação

# Exemplo de saída
Arquivos relevantes encontrados:
- src/auth/login.ts
- src/auth/register.ts
- src/auth/middleware.ts
- tests/auth.test.ts

Plataformas Suportadas

  • Claude Code
  • Cursor
  • Codex
  • Qualquer plataforma com suporte a SKILL.md

Instalação

  1. Adicione o arquivo SKILL.md ao seu projeto
  2. Configure o gatilho de prompt
  3. Use @spotter seguido da sua consulta

Exemplo de SKILL.md

name: spotter
description: Localiza arquivos relevantes antes da leitura
triggers:
  - "@spotter"
  - "/scope"
actions:
  - run: find . -type f -name "*${query}*" | head -20

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests.

Licença

MIT

Habilidades Relacionadas