Files
settled-reach/.claude/skills/docs-search/SKILL.md
T
jpmschweitzerandClaude Opus 4.6 bc226d8baf chore(db): move db/connectors/ to tooling/db/ (#274)
Consolidates all connector scripts under tooling/ per project
structure conventions. Symlink at db/connectors → tooling/db/
preserves backwards compatibility (remove after Sprint 22).

Updated references in CLAUDE.md, Makefile, DEVOPS.md, all skill
files, agent files, rules, schema comments, and Sprint 21
briefings. Python scripts updated with correct SCHEMA_PATH
(now relative to WORKTREE_ROOT/db/schema.sql).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-27 11:08:00 +01:00

1.6 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. Endpoints are in .claude/rules/local-services.md. This skill covers advanced operations and workflows.

Advanced Commands

Index a single chunk

For precise indexing of specific content:

python3 tooling/db/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 tooling/db/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
  tooling/db/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