Chat History

Extract and organize Claude Code session history into project .chats directory. Use when users want to document their Claude sessions, export conversation inputs, or maintain a log of instructions given to Claude.

45 stars 11 forksAI, LLMs & Agents Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add tyrchen/claude-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add tyrchen/claude-skills --skill chat-history
Manual install
git clone --depth 1 https://github.com/tyrchen/claude-skills.git /tmp/claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skills/chat-history ~/.claude/skills/chat-history

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Chat History Extractor

Extract user inputs from Claude Code session history (`~/.claude/projects/`) and organize them into a project's `.chats` directory with daily markdown files.

## When to Use This Skill

Use this skill when the user wants to:
- **Extract session history** from Claude Code sessions
- **Document conversations** for future reference
- **Create instruction logs** organized by date
- **Export user inputs** from `.jsonl` session files
- **Maintain a changelog** of Claude interactions

## How It Works

Claude Code stores session data in `~/.claude/projects/{project-path-encoded}/` as `.jsonl` files. Each file contains messages with:
- `type: "user"` - User messages
- `userType: "external"` - External user (not system/agent)
- `message.content` - The actual message content

This skill extracts meaningful user instructions (filtering out system commands, tool results, and session continuations) and organizes them by date into `.chats/{YYYYMMDD}.md` files.

## Instructions

### Step 1: Identify the Project Session Directory

The session directory is derived from the current working directory path:
- Replace `/` with `-` in the path
- Prefix with `-`
- Location: `~/.claude/projects/{encoded-path}/`

```bash
# Example: /Users/tchen/projects/tubi/titc
# Becomes: -Users-tchen-projects-tubi-titc
# Full path: ~/.claude/projects/-Users-tchen-projects-tubi-titc/
```

### Step 2: Find Session Files by Date

List session files and filter by modification date:
Read the full skill on GitHub

Details

Skill name
chat-history
Path
chat-history/SKILL.md
Repo updated
13 April 2026

FAQ

What does the Chat History skill do?

Extract and organize Claude Code session history into project .chats directory. Use when users want to document their Claude sessions, export conversation inputs, or maintain a log of instructions given to Claude.

How do I install the Chat History skill?

Claude Code plugin: /plugin marketplace add tyrchen/claude-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Chat History popular?

It lives in tyrchen/claude-skills, which has 45 GitHub stars and 11 forks.

Related skills

AI Image

45

tyrchen/claude-skills

Generate AI images using OpenAI's gpt-image-1 model with customizable aspect ratios and artistic themes. Use when the user wants to create images, generate artwork, or mentions image generation with specific styles like Ghibli, futuristic, Pixar, oil painting, or Chinese painting.

Images, Video & Audio11

Cel K8S

45

tyrchen/claude-skills

Write production-ready CEL (Common Expression Language) code for Kubernetes ValidatingAdmissionPolicies, CRD validation rules, and security policies. Use when users need to create admission policies, validate Kubernetes resources, enforce security constraints, or write CEL expressions for Kubernetes.

DevOps & Cloud11

Codex Code Review

45

tyrchen/claude-skills

Perform comprehensive code reviews using OpenAI Codex CLI. This skill should be used when users request code reviews, want to analyze diffs/PRs, need security audits, performance analysis, or want automated code quality feedback. Supports reviewing staged changes, specific files, entire directories, or git diffs.

Software Development11

Label Manager

43

coracoo/zspace_skill

管理和查询 ZSpace NAS 标签——按文件名打标(label-manager scan)、按文件内容语义搜打标(RAG)、按标签找文件、新建/删除标签。 触发词:打标签、给 XX 打 XX 标签、按标签找、找所有带 XX 标签的文件、新建标签、删除标签、给 XX 内容的文件打标签、智能打标、语义打标、给一年级的文件打《一年级》标签、给课本打标签、按内容找文件打标、给所有 XX 内容的文件批量打标。 不适用:文件重命名(用 MCP file_rename)、笔记搜索(用 MCP notebook_search)。

AI, LLMs & Agents13

Pannelai Embeddings

49

rusmanadodi2598/pannelAI

Embeddings through pannelAI. Covers POST /api/v1/embeddings, the provider/model string, the input field, and the OpenAI embeddings answer with its usage block. Use when a client needs vectors for RAG or semantic search from the gateway.

AI, LLMs & Agents

Nas Setup

43

coracoo/zspace_skill

Use when 用户说"连不上 NAS"、"检查 NAS 连接状态"、"NAS 环境有问题"、任何 MCP tool 返回 N001208/N001414 等鉴权错误、skill 跑之前先确认环境。所有其他 NAS skill 的第一步都应该先调此 skill。 触发词:检查 NAS、NAS 环境、连不上 NAS、NAS 连接状态、setup nas、NAS 配置检查、check nas。 不适用:不是解决具体业务问题的 skill — 只做环境校验;具体功能用对应的 skill。

AI, LLMs & Agents13

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.