Files
settled-reach/whatsinagame/templates/.claude/skills/docs-search/SKILL.md
T
jpmschweitzerandClaude Opus 4.6 b025fe8152 chore(db): remove db/connectors backwards-compat symlink (#568)
Remove the db/connectors → tooling/db/ symlink added in Sprint 21
(#274) and migrate all references to use tooling/db/ directly.

- Delete tracked symlink from db/connectors
- Remove duplicate db/connectors/* permission patterns from settings
- Update project-structure.md to reflect removal
- Move whatsinagame/static/db/connectors/ to whatsinagame/static/tooling/db/
- Update 20 whatsinagame template, skill, and test files
- Update comment references in client/tests/test_anti_tedium.gd
- Historical docs (old sprint briefings, changelog, discussions) left as-is

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-28 22:13:26 +01:00

1.9 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. 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.

Commands

tooling/db/qdrant-search "search query"

Index a file

tooling/db/qdrant-index <file-path>

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

Health check

tooling/db/qdrant-health

Count documents

tooling/db/qdrant-count

Bulk Indexing

Index all project documents at once:

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

Adjust the glob patterns to match your project's document locations.

Fallback

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

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

Workflow

  1. Documenter/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