Agent skill
search-davidroliverba-architectkb
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/search-davidroliverba-architectkb
SKILL.md
/search
Smart search using BM25 relevance ranking. Queries the graph index first with ranked results, then falls back to grep for content search.
Usage
/search kafka
/search "API gateway"
/search type:Adr status:proposed
/search backlinks:Project - MyProject
Instructions
When the user invokes /search <query>:
Phase 1: Parse Query Type
Determine what kind of search this is:
| Pattern | Search Type | Action |
|---|---|---|
type:<Type> |
Type filter | Use graph --type |
status:<status> |
Status filter | Use graph --status |
priority:<priority> |
Priority filter | Use graph --priority |
backlinks:<note> |
Backlink search | Use graph --backlinks |
| Simple keyword | Keyword search | Use graph --search, then grep |
| Regex pattern | Content search | Skip to grep |
Phase 2: Query Graph Index First
Always start with the graph index (unless it's a regex):
# Check index exists
if [ ! -f ".graph/index.json" ]; then
npm run graph:build
fi
# Run graph query
node scripts/graph-query.js --search "<query>"
Phase 3: Evaluate Results
After running the graph query:
- If results found: Present them formatted as a table
- If no results OR user needs content search: Fall back to grep
# Grep fallback for content search
grep -r "<query>" --include="*.md" --exclude-dir=".git" --exclude-dir=".obsidian" --exclude-dir="node_modules" --exclude-dir=".smart-env"
Phase 4: Present Combined Results
Format output with BM25 relevance scores:
## Search Results for "<query>"
### Graph Index Results (BM25 ranked)
Found **X** notes matching in graph index:
| Score | Type | Title |
|-------|------|-------|
| 14.65 | Page | Kafka to SAP Integration |
| 11.32 | Adr | ADR - Kafka Integration |
| 9.45 | Meeting | Data Platform Discussion |
*Results ranked by relevance (higher score = better match)*
### Content Search Results (full-text)
Found **Y** additional matches in note content:
- `Page - Kafka Architecture.md:45` - "...kafka cluster configuration..."
- `Meeting - 2025-01-10 Data Team.md:12` - "...discussed kafka..."
Query Shortcuts
| Shortcut | Expands To |
|---|---|
/search t:Adr |
--type Adr |
/search s:active |
--status active |
/search p:high |
--priority high |
/search b:Note |
--backlinks "Note" |
/search orphans |
--orphans |
/search broken |
--broken-links |
/search stale |
--stale |
Examples
/search kafka # Keyword in graph + content
/search type:Meeting kafka # Meetings mentioning kafka
/search backlinks:Project - MyProject # Notes linking to project
/search status:proposed # All proposed items
/search orphans # Orphaned notes
/search "event.*driven" # Regex - grep only
Performance Notes
- Graph search (BM25): ~50ms for 1500 notes (pre-indexed with ranking)
- Grep search: ~2-5s depending on vault size
- Combined: Graph first catches 80%+ of searches instantly
- Relevance ranking: Results are sorted by BM25 score, so top results are most relevant
- IDF weighting: Rare terms like "kafka" score higher than common terms like "the"
Related
/graph-query- Direct graph queries with more options/orphans- Dedicated orphan analysis/broken-links- Dedicated broken link analysis
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?