---
name: Claude Historian
slug: claude-historian
category: AI Engineering
description: Claude Historian searches past conversations, errors, sessions, files, and plans before starting fresh. Use it to recall prior fixes, decisions, and recent work in a familiar project.
github: "https://github.com/Vvkmnn/claude-historian-mcp/tree/master/.claude/skills/claude-historian"
language: TypeScript
stars: 178
forks: 18
install: "npx degit https://github.com/Vvkmnn/claude-historian-mcp/tree/master/.claude/skills/claude-historian ~/.claude/skills/claude-historian"
installs_to: ~/.claude/skills/claude-historian
source_path: .claude/skills/claude-historian/SKILL.md
collection_size: 1
category_size: 3475
added: 2026-09-07T05:20:50.282Z
last_synced: 2026-09-07T05:20:50.282Z
canonical_url: "https://dirskills.com/skills/claude-historian"
---

# Claude Historian

Claude Historian searches past conversations, errors, sessions, files, and plans before starting fresh. Use it to recall prior fixes, decisions, and recent work in a familiar project.

**Install:**

```bash
npx degit https://github.com/Vvkmnn/claude-historian-mcp/tree/master/.claude/skills/claude-historian ~/.claude/skills/claude-historian
```

## README

# Claude Historian

Search conversation history before starting fresh. You may already have the answer.

## When to Use

**Before WebSearch** → `search(query: "...", scope: "similar")` or `search(query: "...", scope: "conversations")`. Past solutions beat web results.

**Stuck on an error** → `search(query: "<error message>", scope: "errors")`. Finds past fixes with code.

**Entering a familiar project** → `search(scope: "sessions")` for recent work. `search(query: "...", scope: "plans")` for past decisions.

**Working on a familiar file** → `search(scope: "files", filepath: "src/index.ts")`. Shows past changes with context.

## Quick Reference

| Situation | Tool Call |
|-----------|----------|
| Error with no obvious cause | `search(query: "<error>", scope: "errors")` |
| "Have I done this before?" | `search(query: "...", scope: "similar")` |
| Working on familiar file | `search(scope: "files", filepath: "...")` |
| Need past design reasoning | `search(query: "...", scope: "plans")` |
| What did I do last session? | `search(scope: "sessions")` |
| Successful tool workflows | `search(scope: "tools")` |
| General search | `search(query: "...", scope: "conversations")` |
| Deep-dive into session | `inspect(session_id: "...")` |
| Rules, skills, CLAUDE.md | `search(query: "...", scope: "config")` |
| Task management history | `search(query: "...", scope: "tasks")` |
| Memories across sessions | `search(query: "...", scope: "memories")` |

## Key Parameters

- **`scope`**: Target your search — `conversations`, `errors`, `files`, `plans`, `config`, `tasks`, `similar`, `sessions`, `tools`, `memories`, or `all` (default)
- **`limit`**: Number of results (default 10)
- **`project`**: Filter by project name substring (works with conversations, sessions)
- **`timeframe`**: `today`, `yesterday`, `week`, `month`

## Common Mistakes

| Mistake | Fix |
|---------|-----|
| Going straight to WebSearch | Check historian first — past solutions are more relevant |
| Vague queries | Use specific terms: error messages, file paths, tool names |
| Using `scope: "all"` for errors | Use `scope: "errors"` — it has dedicated fix extraction |
| Long keyword-dump queries | Keep to 3-5 specific terms, not 10+ generic ones |