/claude-historian
Use before WebSearch to check if you already have the answer, when stuck on an error to find past fixes, or when entering a familiar project to recall past sessions and file changes.
$ npx -y skills add Vvkmnn/claude-historian-mcp --skill claude-historian --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/claude-historian
Context preview
The summary Claude sees to decide when to auto-load this skill.
Use before WebSearch to check if you already have the answer, when stuck on an error to find past fixes, or when entering a familiar project to recall past sessions and file changes.
SKILL.md
claude-historian.SKILL.mdname: claude-historian
description: Use before WebSearch to check if you already have the answer, when stuck on an error to find past fixes, or when entering a familiar project to recall past sessions and file changes.
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 |
Read more
name: claude-historian description: Use before WebSearch to check if you already have the answer, when stuck on an error to find past fixes, or when entering a familiar project to recall past sessions and file changes.
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 |
An Model Context Protocol (MCP) server for searching your Claude Code conversation history. Find past solutions, track file changes, and learn from previous work.
Repo: Vvkmnn/claude-historian-mcp