convez.ai
SkillProdutividadeIntermediário
nanameru

CC Handoff Skill

nanameru/claude-transcript-handoff-skill

Extrai e estrutura transcrições do Claude Code para handoff entre agentes

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill que extrai histórico de conversas do Claude Code de arquivos de transcrição locais e converte em artefatos de handoff para outro agente ou pessoa. Processa transcrições JSONL, redaciona dados sensíveis e gera múltiplos formatos de saída (markdown, TSV, JSONL) para documentação e transferência de contexto.

Instalação

$npx convez-ai nanameru/claude-transcript-handoff-skill

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
18
Forks
1
Acompanhando
0
Saúde
14%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Transferir sessões longas do Claude Code para outro agente ou colega
  • Documentar o que foi feito em um branch: mensagens, edições e ferramentas utilizadas
  • Exportar histórico de conversas em múltiplos formatos (markdown, TSV, JSONL)
  • Rastrear chamadas de ferramentas e resultados de forma estruturada

Veredito

Skill especializada para quem trabalha com Claude Code e precisa documentar, auditar ou transferir sessões. Solução bem pensada com redação de segredos integrada, mas exige familiaridade com Node.js e estrutura de projetos locais.

README

A tradução para o português deste README ainda está na fila.

CC Handoff Skill

Extract Claude Code conversation history from local transcript files and turn it into handoff artifacts for another agent or human.

This skill is useful when you want to answer questions like:

  • What did Claude Code do in this branch?
  • What chat messages were shown, not just file edits?
  • Which tools did Claude Code run?
  • Where are the original transcript files?
  • How can I hand off a long Claude Code session to Codex, another Claude Code session, or a teammate?

What It Extracts

The bundled script reads Claude Code transcript JSONL files under ~/.claude/projects/ and writes:

  • summary.md: session summaries, tool counts, first/last messages, output file list
  • assistant-visible-messages.md: assistant messages shown in Claude Code chat
  • user-visible-messages.md: user prompts, excluding tool-result pseudo-user entries
  • tool-uses.tsv: spreadsheet-friendly tool call list
  • tool-uses.jsonl: machine-readable tool calls
  • tool-results.jsonl: redacted tool outputs
  • timeline.jsonl: chronological event stream
  • raw-transcript-locations.json: source transcript file paths

Common bearer tokens, JWTs, API keys, and secret-like assignments are redacted by default.

Install

Install with the Vercel Labs Skills CLI:

npx skills add nanameru/claude-transcript-handoff-skill --skill cc-handoff -g -a codex -a claude-code -y

List the skill without installing:

npx skills add nanameru/claude-transcript-handoff-skill --list

Use

After installing, ask your agent to use $cc-handoff.

You can also run the script directly:

node skills/cc-handoff/scripts/extract-claude-transcript.mjs

Run against a specific worktree:

node skills/cc-handoff/scripts/extract-claude-transcript.mjs \
  --cwd /path/to/worktree

Choose an output directory:

node skills/cc-handoff/scripts/extract-claude-transcript.mjs \
  --cwd /path/to/worktree \
  --out-dir ./handoff

List candidate Claude project directories:

node skills/cc-handoff/scripts/extract-claude-transcript.mjs \
  --cwd /path/to/worktree \
  --list-candidates

Safety Notes

Transcript files can include sensitive prompts, command output, file paths, and secrets. Redaction is best-effort, not a guarantee.

Avoid committing generated handoff files unless you have reviewed them and explicitly intend to publish them.

This extracts persisted transcript fields and chat-visible text. It does not recover private model reasoning or anything that Claude Code did not save to transcript files.

Requirements

  • Node.js 18+
  • Local Claude Code transcript files under ~/.claude/projects/
  • Optional: npx skills for installation into supported coding agents

Repository Layout

skills/
  cc-handoff/
    SKILL.md
    agents/openai.yaml
    scripts/extract-claude-transcript.mjs
Ver o original no GitHub

Bom para

Relacionados