analytics-skills

O que analytics-skills faz?

Habilidades para agente que ensinam Claude, Cursor e outros agentes de IA a ler análises web como um analista sênior. Diagnostique mudanças de tráfego, avalie qualidade de canais e analise funis sem os erros comuns de iniciantes. Funciona com qualquer fonte de análise; suporte de primeira linha para Clamp MCP.

O que está incluído

Habilidade	O que faz
analytics-profile-setup	Entrevista única que captura seu contexto de negócio (modelo, conversão primária, faixa de tráfego, ICP, stack de dados) em um analytics-profile.md local. Todas as outras habilidades leem este arquivo para que as respostas sejam calibradas para seu setor e escala. Execute esta primeiro.
analytics-diagnostic-method	A espinha dorsal. Método de cinco etapas: carregar perfil, enquadrar a pergunta, construir uma árvore de hipóteses MECE, triangular, apresentar com o Princípio da Pirâmide. Abrange sinal vs ruído e o paradoxo de Simpson. Referenciado por todas as outras habilidades.
traffic-change-diagnosis	Caminho de investigação para "por que o tráfego mudou". Impressões digitais para regressões de rastreamento, picos de bots, quedas correlacionadas a deploys, rampas de campanhas, deterioração de SEO e mudanças de plataforma. Verificações de medição primeiro, sempre.
channel-and-funnel-quality	Volume × engajamento × conversão como uma matriz. Detecção de tráfego de vaidade. Faixas esperadas de queda por etapa do funil. Tratamento de mudanças de mix. Benchmarks específicos do setor.
metric-context-and-benchmarks	O que é uma boa taxa de rejeição / engajamento / duração / CVR / churn / LTV:CAC / ativação, por modelo. Quando cada métrica mente. Tamanhos mínimos de amostra antes de confiar em uma taxa.

Instalação

Escolha a que melhor se adequa à sua configuração. Todas as três instalam as mesmas habilidades.

Claude Code, plugin (recomendado)

# Adicione o marketplace uma vez
/plugin marketplace add clamp-sh/analytics-skills

# Instale
/plugin install analytics-skills@clamp-sh

As habilidades ficam disponíveis como /analytics-skills:<nome> e são invocadas automaticamente quando a tarefa corresponde.

Qualquer agente (Cursor, Claude Code, Copilot, outros)

Instale via CLI de skills aberta da Vercel skills CLI:

npx skills add clamp-sh/analytics-skills

Funciona com qualquer ferramenta que suporte a especificação Agent Skills.

Claude Code, autônomo (sem mecanismo de plugin)

Clone em seu diretório pessoal de skills:

git clone https://github.com/clamp-sh/analytics-skills.git /tmp/analytics-skills
cp -R /tmp/analytics-skills/skills/* ~/.claude/skills/

Ou execute o instalador integrado que cria links simbólicos para cada skill (então git pull as atualiza):

git clone https://github.com/clamp-sh/analytics-skills.git ~/.analytics-skills
~/.analytics-skills/scripts/install-personal.sh

Para um único projeto, clone em .claude/skills/ dentro do repositório.

claude.ai

Construa os zips por skill e faça upload de cada um via Configurações → Recursos → Habilidades:

./scripts/build-claude-ai-zips.sh
# Produz dist/analytics-diagnostic-method.zip etc.

Zips pré-construídos para cada versão também estão anexados à página de release do GitHub.

Uso

Estas são habilidades invocadas por modelo. Você não precisa chamá-las pelo nome; basta fazer perguntas reais de análise e o Claude carregará a habilidade relevante.

Primeira execução, em um novo projeto:

Me configure. Quero as habilidades calibradas para meu negócio.

Isso carrega analytics-profile-setup, executa uma entrevista de 5 minutos e escreve analytics-profile.md na raiz do repositório. Cada pergunta subsequente receberá respostas conscientes do setor.

Após a configuração, faça perguntas reais:

O tráfego caiu 30% na terça-feira. O que aconteceu?

Carrega traffic-change-diagnosis. Percorre a árvore de hipóteses (medição → formato temporal → canal → coorte → conteúdo), obtém números de sua fonte de análise e retorna um diagnóstico. Não é uma captura de tela de um gráfico.

Nosso funil de cadastro está quebrado? O funil da página de preços ao checkout está convertendo a 14%.

Carrega channel-and-funnel-quality e metric-context-and-benchmarks. Compara com a queda esperada por etapa, segmenta por coorte e sinaliza se 14% é baixo, normal ou suspeito, dado seu tamanho de amostra e modelo.

Nossa taxa de rejeição é de 68%. Isso é ruim?

Carrega metric-context-and-benchmarks. Lida com a diferença de definição entre GA4 e UA, consulta a faixa relevante para o tipo de página e sinaliza a ressalva de tamanho de amostra, se necessário.

Funciona melhor com Clamp MCP

As habilidades são agnósticas em relação à análise, mas incluem chamadas de ferramentas específicas do Clamp. Se você tiver o Clamp MCP conectado, o agente saberá exatamente qual ferramenta usar em cada etapa do método (get_overview, get_top_referrers, create_funnel, etc.).

Usando uma fonte de análise diferente? O método ainda se aplica; apenas os nomes das ferramentas mudam.

Contribuição

Issues e PRs são bem-vindos. As habilidades ficam em skills/<nome>/SKILL.md. Consulte a especificação Agent Skills para o formato do arquivo.

Regras de estilo para este repositório:

• Coloque o caso de uso principal no início da description da habilidade (os primeiros 200 caracteres decidem se ela será carregada).
• Mantenha SKILL.md abaixo de 400 linhas. Mova tabelas de referência longas para arquivos .md irmãos.
• Metodologia primeiro, nomes de ferramentas depois. Uma habilidade que funciona apenas com um produto de análise é menos valiosa do que uma que funciona em todos os lugares.
• Sem travessões.

Licença

MIT. Veja LICENSE.