Agent-Skills.md

Agent Skills: Conversation History Search

Search indexed conversation history to find past conversations, locate when topics were discussed, or identify which project conversations occurred in. Use when user asks questions like "when did we discuss X?", "find conversations about Y", "in which project did we talk about Z?", or "show me conversations mentioning W". Works across all projects or within current project.

UncategorizedID: dhughes/claude-marketplace/conversation-search

Repository

dhughes/claude-marketplace
dhughesLicense: MIT
1

Install this agent skill to your local

pnpm dlx add-skill https://github.com/dhughes/claude-marketplace/tree/HEAD/plugins/conversation-history/skills/conversation-search

Skill Files

Browse the full folder contents for conversation-search.

Download Skill

Loading file tree…

plugins/conversation-history/skills/conversation-search/SKILL.md

Skill Metadata

Name
conversation-search
Description
Search indexed conversation history to find past conversations, locate when topics were discussed, or identify which project conversations occurred in. Use when user asks questions like "when did we discuss X?", "find conversations about Y", "in which project did we talk about Z?", or "show me conversations mentioning W". Works across all projects or within current project.

Conversation History Search

Search through indexed past conversations with Claude to find relevant discussions.

How to Search

Run the search command with the user's query:

bash ${CLAUDE_PLUGIN_ROOT}/skills/conversation-search/scripts/search.sh --query "search terms" --limit 10

Options:

  • --query: Search terms (required). Supports prefix matching.
  • --limit: Maximum results (default: 20)
  • --json: Output results as JSON for programmatic processing

Presenting Results

Show the user:

  • Number of matching conversations found
  • For each result: conversation ID, project path, date, and snippet
  • Suggest using /conversation-history:load-conversation <id> to load full transcripts

First-Time Setup

If search returns no results and the user seems surprised, they may need to run the initial indexing:

/conversation-history:index-history

This indexes all existing conversations from ~/.claude/projects/ into the database.