Skills · Claude Code

Três skills pra sua sessão do Claude Code não virar bagunça.

Handoff antes do /clear, checkpoint no meio do trabalho e auditoria da memória. Cada uma com um trabalho só, em PT e EN.

skillmanager3x — biblioteca de skills de gestão de sessão
O que é

Uma biblioteca de gestão de sessão — não um framework

Não há build, dependências nem código executável. Cada skill é uma pasta com um SKILL.md (markdown + frontmatter YAML) que o Claude Code carrega quando você fala um dos gatilhos.

🤝 session-handoff

Passa o bastão antes do /clear ou da troca de agente. Resumo terso, escrito pra outra instância do Claude ler — paths absolutos, processos em background e marcadores [confirmed] / [unverified] / [?].

📊 session-statusline

Checkpoint rápido durante o trabalho: foco atual, o que foi pra memória, decisões recentes, próximos passos e uma recomendação (continuar, compactar, auditar, handoff ou limpar).

🧹 memory-audit

Inventário do que está em ~/.claude/projects/<projeto>/memory/ e no CLAUDE.md. Separa fato durável (mantém) de estado de curto prazo (descarta) e ruído (remove).

Como funciona

Gatilhos que não se sobrepõem

Regra de bolso: fim de sessão → handoff. "Como estamos?" → statusline. "O que tem na memória?" → audit. Você fala em linguagem natural, o harness casa com a description do frontmatter e carrega a skill certa.

Você fala o gatilho→ Claude Code casa a description→ Carrega o SKILL.md→ Segue o formato de saída→ Responde no chat

🤝 Gatilhos do handoff

"handoff", "vou dar /clear", "encerrar sessão", "passar para outro agente", "wrap up", "resumo final antes de limpar".

📊 Gatilhos da statusline

"statusline", "checkpoint", "onde estamos", "como está a sessão", "próximos passos", "organiza/otimiza a sessão".

🧹 Gatilhos do audit

"analise a memória", "analise CLAUDE.md", "o que foi guardado", "memória inchada", "limpa memória".

Pré-requisitos

Basicamente nada

Se você já usa o Claude Code, está pronto. Não há instalação de pacote, runtime nem serviço no ar.

Claude Code

O CLI da Anthropic, com suporte a skills (pasta skills/ varrida no start).

# conferir que está instalado
claude --version

O repositório

Clone (ou baixe) — as skills são só arquivos de texto.

git clone https://github.com/inematds/skillmanager3x
cd skillmanager3x

Uma pasta de skills

Global (todas as sessões) ou por projeto. Crie se não existir.

# global
mkdir -p ~/.claude/skills
Guia de uso · passo a passo

Do clone ao primeiro handoff

Cinco passos. O mais longo leva um minuto.

1

Clone o repositório

As skills vivem em skill/pt/ e skill/en/ — mesma estrutura nos dois idiomas.

git clone https://github.com/inematds/skillmanager3x
cd skillmanager3x
2

Escolha o idioma

Os campos name e description ficam em inglês nas duas versões (pra triggering consistente do harness), mas a description de pt/ inclui gatilhos em português.

ls skill/pt   # session-handoff  session-statusline  memory-audit
ls skill/en   # mesma estrutura, textos em inglês
3

Instale as skills

Copie a pasta inteira de cada skill — com o SKILL.md dentro. Não achate a estrutura.

# global — vale em todas as sessões
mkdir -p ~/.claude/skills
cp -r skill/pt/session-handoff    ~/.claude/skills/
cp -r skill/pt/session-statusline ~/.claude/skills/
cp -r skill/pt/memory-audit       ~/.claude/skills/

# ou por projeto
cp -r skill/pt/session-handoff <projeto>/.claude/skills/
4

Verifique que registrou

No Claude Code, liste as skills disponíveis. As três devem aparecer.

/skills   # session-handoff · session-statusline · memory-audit
5

Use pelo gatilho, não pelo nome

Você não precisa decorar comandos — fale naturalmente e a skill certa entra.

# fim de sessão
vou dar /clear, faz handoff antes

# no meio do trabalho
statusline

# revisar memória
analise a memória do projeto, tá bagunçada
Exemplos

Como é a saída de verdade

Três formatos, três propósitos. Tudo sai no chat — nenhuma das skills grava arquivo por conta própria.

🤝 Handoff — refatoração de auth

Terso, com marcadores de confiança e estado de execução.

# Session Handoff — refatoração do middleware de auth

## Applied / shipped
- [confirmed] /auth/jwt_validator.py extraído de middleware.py:45-180
- [confirmed] testes em /tests/auth/ — 12/12 passando

## Proposed / attempted but not confirmed
- [unverified] cache de chaves públicas TTL 5min — sem teste
- [?] migração v1→v2 — usuário queria revisar antes

## Running state
- Background: shell_a3f → pytest --watch

## Pick up here
Revisar se a migração v1→v2 entra agora.

📊 Statusline — checkpoint

Termina sempre com uma Recomendação: qual skill (ou nenhuma) faz sentido em seguida.

# Statusline

## Estado
- Foco atual: ajustar paginação do endpoint /users
- Contexto: moderado
- Risco: sem teste de carga com >10k registros

## O que ficou guardado na memória
- Guardado confirmado: none
- Candidatos: prefere keyset sobre offset

## Próximos passos
1. Rodar teste com 50k registros
2. Atualizar OpenAPI schema

## Recomendação
continuar

🧹 Memory audit — inventário

A saída é recomendação, não execução. Se quiser aplicar os cortes, peça numa segunda etapa: "ok, aplica isso".

# Memory Audit

## Manter (fatos duráveis)
- user_role.md → user é eng. backend Go, novo em React
- feedback_testing.md → testes de integração no Postgres real (incidente Q3/2025)

## Considerar mover pro CLAUDE.md
- project_auth_rewrite.md → motivação (compliance) — vale na doc do projeto

## Remover (curto prazo / ruído)
- session_2026-04-15.md → estado de sessão antiga
- bug_fix_recipe_xyz.md → fix já aplicado, código fala por si

## Pontos de atenção
- Duplicação: feedback_pr_size.md e feedback_review_style.md
- Stale: reference_grafana.md aponta pra dashboard que mudou de URL
Bônus · statusline-cmd

A barra que te diz onde você está — e quanto sobrou

Fora as três skills, o repo traz uma statusline pro Claude Code: a linha fixa abaixo do input, com diretório, modelo, esforço, contexto restante e quanto do seu limite já foi embora. Um comando pra instalar.

# o que aparece no terminal
nei@maquina:~/projetos/wifi Opus 5/low ctx 10% 5h:24%→00:10 w:29%→10/08 21:00 d:109.6M

🧭 Onde e com quê

user@host:cwd mais Opus 5/low — o modelo e o nível de esforço da sessão, acompanhando o que você escolheu no /model.

🪟 Quanto de contexto

ctx 10% — o quanto da janela já foi usado. É o número que diz se dá pra continuar ou se está na hora de um handoff.

⏳ Quanto de limite

5h:24%→00:10 e w:29%→10/08 21:00 — uso e horário de reset das janelas de 5 horas e semanal. d:109.6M são os tokens do dia.

1

Instale com um comando

O script copia a statusline para ~/.claude/ e registra o bloco statusLine no seu settings.json — preservando o resto do arquivo, com backup .bak.

git clone https://github.com/inematds/skillmanager3x
bash skillmanager3x/statusline-cmd/install.sh
2

Confira a prévia

O instalador imprime a linha já montada com os seus dados. Ela aparece no próximo render do Claude Code — nenhuma sessão precisa ser reiniciada.

# dependências, se faltar alguma
sudo apt install jq curl python3
3

Se quiser tirar

O desinstalador remove só a chave statusLine do settings.json; o resto das suas configurações fica intacto.

bash statusline-cmd/install.sh --uninstall

Os percentuais de 5h e semana vêm do endpoint de uso da Anthropic usando as suas próprias credenciais (~/.claude/.credentials.json) — nenhum token vai no repositório. Detalhes, campos disponíveis e como personalizar: statusline-cmd/README.md.

Nomes parecidos, coisas diferentes: a skill session-statusline escreve um checkpoint em texto quando você pede; a pasta statusline-cmd instala a barra fixa do terminal.

Roadmap

Onde está e pra onde vai

O projeto é pequeno de propósito: três skills disjuntas, sem sobreposição de gatilho.

Feito
As três skills, em PT e ENsession-handoff, session-statusline e memory-audit, com SKILL.md completo nos dois idiomas e READMEs detalhados em skill/en/ e skill/pt/ cobrindo decisões de design.
Feito
Gatilhos sem sobreposiçãoCada skill tem um trabalho só. A statusline termina com uma recomendação que aponta pra próxima — o roteamento é explícito, não adivinhado.
Convenção
Sincronizar en/pt ao editarAs duas versões têm a mesma estrutura. Ao mexer numa skill, atualize as duas — é a regra de manutenção do repo.
Próximo
Persistência opcional do handoffHoje a saída é só chat; pra guardar, você copia o texto. Um modo de gravar em arquivo é o candidato natural de evolução.