atualiza definições de skills e plugins do Claude com melhorias locais

core-tools/skills/metrics/SKILL.md

@@ -36,6 +36,43 @@ Complementa `/reflect` (qualitativo) com dados quantitativos, `/worklog` com met
 | `/metrics --roi` | ROI por cliente/projecto |
 | `/metrics --export` | Exportar JSON/CSV |
 | `/metrics --alerts` | Listar alertas activos |
+| `/metrics --tools` | **Telemetria local de tool calls (ver secção Local Tool Telemetry)** |
+
+---
+
+## Local Tool Telemetry (G3.1-B)
+
+Desde 08-04-2026 há captura universal de **todas** as tool calls do Claude Code via hook PostToolUse (`~/.claude/hooks/telemetry-posttool-hook.sh`). Complementa a telemetria Desk CRM com dados locais imediatos.
+
+**Ficheiro:** `~/.claude-work/tool-invocations.jsonl` (1 linha por tool call: ts, session, tool_use_id, tool_name, success, error)
+
+**Agregador:** `/media/ealmeida/Dados/Dev/ClaudeDev/tool-metrics.py`
+
+```bash
+# Overview últimas 24h
+python3 /media/ealmeida/Dados/Dev/ClaudeDev/tool-metrics.py
+
+# Só hoje
+python3 /media/ealmeida/Dados/Dev/ClaudeDev/tool-metrics.py --today
+
+# Últimos 7 dias
+python3 /media/ealmeida/Dados/Dev/ClaudeDev/tool-metrics.py --last 7d
+
+# Filtrar por sessão
+python3 /media/ealmeida/Dados/Dev/ClaudeDev/tool-metrics.py --session <session_id>
+
+# Output JSON (para pipeline/grafos)
+python3 /media/ealmeida/Dados/Dev/ClaudeDev/tool-metrics.py --json
+```
+
+**Output:** total de invocations, sessões únicas, top 20 tools (contagem + %), falhas por tool com amostras de erro, top 5 sessões por volume.
+
+**Limitações conhecidas:**
+- Duration não é capturada (harness não entrega duration no hook payload). Apenas contagem e success/failure.
+- Tokens não capturáveis via hooks (não estão no payload).
+- Só captura tool calls que chegam ao PostToolUse — tool calls bloqueados por hooks PreToolUse não aparecem.
+
+Ver `04-Stack/CHANGELOG.md` bloco 08-04-2026 sessão 2 para contexto do gap e decisão de scope.
 
 ### Agregacoes Disponiveis