Agent Skills: Advanced BK Workflows

Advanced BK Workflows

Multi-tool patterns for efficient knowledge retrieval and management.

Core Patterns

Progressive Library Exploration

1. list_stores() → identify target store
2. search(query, detail='minimal', stores=[target]) → scan summaries
3. get_full_context(top_result_ids) → deep dive on best matches

Add Library + Wait for Index

1. create_store(url, name) → job_id
2. check_job_status(job_id) → poll every 15-30s
3. When completed: search(query, stores=[name]) → verify

Progressive Detail Strategy

1. search(query, detail='minimal', limit=20) → ~100 tokens/result
2. Filter by score (>0.7 = strong match)
3. get_full_context(top_3_ids) → saves ~80% context
4. If nothing relevant: refine query and retry

Cross-Library Comparison

1. search(query, limit=10) → searches ALL stores
2. Review store distribution
3. Narrow: search(query, stores=['lib1', 'lib2'], limit=15)

Best Practices

1. Start with detail='minimal' — summaries first, full context selectively
2. Monitor background jobs — don't search until indexing completes
3. Use intent parameter — 'find-implementation' vs 'find-usage' vs 'find-documentation'
4. Filter by stores — faster, more focused results
5. Check scores — >0.7 strong match, <0.5 likely noise

Detailed examples and error recovery: references/examples.md