claude-code-session-skills

Claude Code 세션을 다루는 스킬 3종입니다. 세션 간 메시지 기능이 나오자마자 실측으로 만들어 실전(세션 6개에 질문을 뿌려 사실 파일을 갱신)까지 돌려본 구성 그대로 공개합니다.

스킬	하는 일
session-handoff	세션 간 작업 인수인계. 페이로드 표준(목표·상태·다음 단계·검증), 전송 후 도착 검증, 새 세션 원클릭 생성(칩), 자동 제안 규칙까지.
session-id-lookup	사이드바 세션 이름으로 원본 세션 ID와 대화 로그(.jsonl) 경로를 찾는다. Claude Code뿐 아니라 Codex(rollout·스레드 이름·첫 프롬프트), Aside(state.db 제목)까지 한 명령으로 통합 검색.
session-image-extract	대화에 붙였던 스크린샷·사진을 세션 로그에서 base64로 되찾는다. 원본 파일을 지웠어도 로그가 있으면 복원된다.

설치

git clone https://github.com/Tygb99/claude-code-session-skills.git
cd claude-code-session-skills
for s in session-handoff session-id-lookup session-image-extract; do
  ln -s "$PWD/$s" ~/.claude/skills/$s
done

Claude Code가 다음 세션부터 스킬을 자동 인식합니다.

요구사항

• macOS 기준 실측. Python 3 표준 라이브러리만 사용 (session-image-extract의 PNG 변환 옵션만 Pillow 필요).
• session-handoff와 session-id-lookup의 Claude 세션 조회는 Claude Code 데스크톱 앱 환경 기준입니다 (세션 메타데이터 위치: ~/Library/Application Support/Claude/claude-code-sessions/).
• Codex·Aside 조회는 해당 도구가 설치된 경우에만 동작하며, 없으면 그 소스만 조용히 건너뜁니다.

주의

전부 비공식 실측 기반입니다. 앱 업데이트로 내부 경로·포맷이 바뀌면 깨질 수 있습니다. 각 SKILL.md에 함정과 한계(예: list_sessions의 local_ ID는 로그 파일명이 아님, 이름이 원래 없는 서브에이전트 세션 약 20%)를 실측 그대로 적어 두었습니다.

라이선스

MIT