# 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. Use when this capability is needed.

- Skill: `tomevault-io/claude-historian` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/claude-historian`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/claude-historian/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/claude-historian

---


# 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 |

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/vvkmnn) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->