| name | agentic-history-search |
| description | Use this skill when a user asks what was done previously in this project (implementation decisions, test commands, prior fixes, function history). The skill searches conversation history with CLI-based agents (Claude/Codex/Cursor), scoped to the current project, and returns citation-backed answers. |
Agentic History Search
Use this skill for project-memory questions, such as:
- "what are the test commands?"
- "how did we implement xyz and why?"
- "what does function x do?"
- "when did we fix this bug before?"
Hard guardrails
- Use conversation history evidence only.
- If evidence is weak, explicitly say so.
- Always return citations when answering.
- Keep scope project-specific unless user asks otherwise.
Execution
Use the launcher (compiled bundle required):
bash skills/agentic-history-search/scripts/run-history-search.sh --mode query_past --query "<user question>"
Recent sessions helper mode:
bash skills/agentic-history-search/scripts/run-history-search.sh --mode recent_sessions --limit 10
The launcher requires skills/agentic-history-search/dist/history-search.mjs.
This skill is expected to ship with prebuilt artifacts in dist/.
Output expectations
For query_past, include:
- concise answer grounded in history
- citations with provider + snippet + source ids when available
- confidence + insufficientEvidence flag
- provider diagnostics
For recent_sessions, include:
- ordered recent sessions
- provider diagnostics
References
- Detailed output contract:
references/OUTPUT_SCHEMA.md
- Provider notes and capability behavior:
references/PROVIDER_COMPATIBILITY.md
- Usage patterns and examples:
references/USAGE_PATTERNS.md
