CC Handoff Skill
nanameru/claude-transcript-handoff-skill
Extrai e estrutura transcrições do Claude Code para handoff entre agentes
Ver no GitHubSkill 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-skill1 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
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 listassistant-visible-messages.md: assistant messages shown in Claude Code chatuser-visible-messages.md: user prompts, excluding tool-result pseudo-user entriestool-uses.tsv: spreadsheet-friendly tool call listtool-uses.jsonl: machine-readable tool callstool-results.jsonl: redacted tool outputstimeline.jsonl: chronological event streamraw-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 skillsfor installation into supported coding agents
Repository Layout
skills/
cc-handoff/
SKILL.md
agents/openai.yaml
scripts/extract-claude-transcript.mjs