Files
settled-reach/.claude/skills/docs-search/SKILL.md
T
jpmschweitzerandClaude Opus 4.6 f0bab3999d chore(skills): rename all skills to domain-action convention
Adopts the whatsinagame naming pattern where the domain comes
first and the action second (e.g. pr-review, sprint-start,
audio-gen). Updated all cross-references in settings, agents,
docs, and inter-skill references.

12 renames: commit→git-commit, create-skill→skill-create,
gen-audio→audio-gen, gen-image→image-gen, plan-sprint→sprint-plan,
push-pr→pr-push, render-sprite→sprite-gen, review-pr→pr-review,
search-docs→docs-search, start-sprint→sprint-start,
start-workshop→workshop-start.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 12:51:56 +01:00

1.7 KiB

name, description, user-invocable, allowed-tools
name description user-invocable allowed-tools
docs-search Search project documents using semantic search (Qdrant + ollama) or grep fallback. Use when the user asks "did we discuss X?", "find references to Y", "search docs", or invokes /docs-search. Wraps the qdrant_connector.py for semantic document search. true Bash, Read, Grep, Glob

Search Docs Skill

Semantic search across project documents. Basic commands (qdrant-search, qdrant-index, qdrant-health, qdrant-count) and endpoints are documented in CLAUDE.md. This skill covers advanced operations and workflows.

Advanced Commands

Index a single chunk

For precise indexing of specific content:

python3 db/connectors/qdrant_connector.py index "unique-id" "Text content to index" --metadata source=manual heading="Custom heading"

Create collection

Initialize the Qdrant collection (run once during setup):

python3 db/connectors/qdrant_connector.py create-collection

Bulk Indexing

Index all project documents at once:

for f in decisions/*.md DISCUSSION.md TEAM.md docs/discussions/*.md docs/briefings/*.md; do
  db/connectors/qdrant-index "$f"
done

Fallback

If Qdrant or ollama is unreachable, fall back to grep-based search:

grep -r -i "search term" decisions/ DISCUSSION.md docs/ --include="*.md"

Workflow

  1. Qatux (Librarian) is the primary user of this skill
  2. After each discussion round, index the archived round file
  3. After briefing updates, re-index affected briefings
  4. After decision changes, re-index the relevant decisions/*.md domain files
  5. Use search to answer "did we discuss this?" questions with citations