Skill: search

Search the full-text index for content across all indexed sources.

When to use

• User asks to "search", "find", "look up" text in their documents
• User wants to know what books cover a topic
• User wants word frequency counts across a project (freq)
• Search returns stale results → run reindex first

Steps Claude must follow

1. Search:

   # All projects:
   arcane search "<query>"
   
   # Scoped to a project:
   arcane search "<query>" --project "<project>"
   
   # Scoped to one source:
   arcane search "<query>" --project "<project>" --source "<title>"
   

   Show the user: result count, top hits (title, chapter, page).

2. If results look stale or empty:

   arcane reindex
   

   Then re-run the search. Reindex is safe to run at any time (idempotent).

3. Word frequency (when user wants "most common words", "term frequency", or to build a vocab list):

   arcane freq "<query>" --project "<project>"
   

   Output is word<TAB>count pairs, sorted descending.

4. Fill in template.md and present the summary.

Notes

• arcane reindex reindexes all sources; there is no per-source flag.
• Sources must be added via arcane add before they can be indexed.
• Encrypted PDFs cannot be indexed until unlocked.