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.
How do I install this agent skill?
npx skills add https://github.com/vvkmnn/claude-historian-mcp --skill claude-historianIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides instructions for the agent to search through its conversation history, error logs, and project files. The primary security concern is the potential for indirect prompt injection, as the agent is encouraged to retrieve and process data from past sessions that might contain untrusted content.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1 file scanned · No issues
What does this agent skill do?
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, orall(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 |
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/vvkmnn/claude-historian-mcp/claude-historian">View claude-historian on skillZs</a>