knowledge-locator
npx machina-cli add skill athola/claude-night-market/knowledge-locator --openclawTable of Contents
- What It Is
- Quick Start
- Search Palaces
- List All Palaces
- When to Use
- Search Modalities
- Core Workflow
- Target Metrics
- Detailed Resources
- PR Review Search
- Quick Commands
- Review Chamber Rooms
- Context-Aware Surfacing
- Integration
Knowledge Locator
A spatial indexing and retrieval system for finding information within and across memory palaces. Enables multi-modal search using spatial, semantic, sensory, and associative queries.
What It Is
The Knowledge Locator provides efficient information retrieval across your memory palace network by:
- Building and maintaining spatial indices for fast lookup
- Supporting multiple search modalities (spatial, semantic, sensory)
- Mapping cross-references between palaces
- Tracking access patterns for optimization
Quick Start
Search Palaces
python scripts/palace_manager.py search "authentication" --type semantic
Verification: Run python --version to verify Python environment.
List All Palaces
python scripts/palace_manager.py list
Verification: Run python --version to verify Python environment.
When To Use
- Finding specific concepts within one or more memory palaces
- Cross-referencing information across different palaces
- Discovering connections between stored information
- Finding information using partial or contextual queries
- Analyzing access patterns for palace optimization
When NOT To Use
- Creating new palace structures - use memory-palace-architect
- Processing new external resources - use knowledge-intake
- Creating new palace structures - use memory-palace-architect
- Processing new external resources - use knowledge-intake
Search Modalities
| Mode | Description | Best For |
|---|---|---|
| Spatial | Query by location path | "Find concepts in the Workshop" |
| Semantic | Search by meaning/keywords | "Find authentication-related items" |
| Sensory | Locate by sensory attributes | "Blue-colored concepts" |
| Associative | Follow connection chains | "Related to OAuth" |
| Temporal | Find by creation/access date | "Recently accessed" |
Core Workflow
- Build Index - Create spatial index of all palaces
- Optimize Search - Configure search strategies and heuristics
- Map Cross-References - Identify inter-palace connections
- Test Retrieval - Validate search accuracy and speed
- Analyze Patterns - Track and optimize based on usage
Target Metrics
- Retrieval latency: ≤ 150ms cached, ≤ 500ms cold
- Top-3 accuracy: ≥ 90% for semantic queries
- Robustness: ≥ 80% success with incomplete queries
Detailed Resources
- Index Structure: See
modules/index-structure.md - Search Strategies: See
modules/search-strategies.md - Cross-Reference Mapping: See
modules/index-structure.md
PR Review Search
Search the review chamber within project palaces for past decisions and patterns.
Quick Commands
# Search review chamber by query
python scripts/palace_manager.py search "authentication" \
--palace <project_id> \
--room review-chamber
# List entries in specific room
python scripts/palace_manager.py list-reviews \
--palace <project_id> \
--room decisions
# Find by tags
python scripts/palace_manager.py search-reviews \
--tags security,api \
--since 2025-01-01
Verification: Run python --version to verify Python environment.
Review Chamber Rooms
| Room | Content | Example Query |
|---|---|---|
decisions/ | Architectural choices | "JWT vs sessions" |
patterns/ | Recurring solutions | "error handling pattern" |
standards/ | Quality conventions | "API error format" |
lessons/ | Post-mortems | "outage learnings" |
Context-Aware Surfacing
When starting work in a code area, surface relevant review knowledge:
# When in auth/ directory
python scripts/palace_manager.py context-search auth/
# Returns:
# - Past decisions about authentication
# - Known patterns in this area
# - Relevant standards to follow
Verification: Run python --version to verify Python environment.
Integration
Works with:
memory-palace-architect- Indexes palaces created by architectsession-palace-builder- Searches session-specific palacesdigital-garden-cultivator- Finds garden content and linksreview-chamber- Searches PR review knowledge in project palaces
Troubleshooting
Common Issues
Command not found Ensure all dependencies are installed and in PATH
Permission errors Check file permissions and run with appropriate privileges
Unexpected behavior
Enable verbose logging with --verbose flag
Source
git clone https://github.com/athola/claude-night-market/blob/master/plugins/memory-palace/skills/knowledge-locator/SKILL.mdView on GitHub Overview
Knowledge Locator is a spatial indexing and retrieval system for finding information within and across memory palaces. It enables multi modal search using spatial, semantic, sensory, and associative queries, maps cross-references between palaces, and tracks access patterns to optimize retrieval.
How This Skill Works
The skill builds spatial indices over all palaces to enable fast lookup and supports multiple search modalities. It maps cross references between palaces and collects usage data to optimize search strategies, guided by a core workflow that includes building the index, optimizing search, mapping references, testing retrieval, and analyzing patterns.
When to Use It
- Finding specific concepts within one or more memory palaces
- Cross-referencing information across different palaces
- Discovering connections between stored information
- Finding information using partial or contextual queries
- Analyzing access patterns for palace optimization
Quick Start
- Step 1: Run a search using python scripts/palace_manager.py search "authentication" --type semantic
- Step 2: Verify Python environment with python --version
- Step 3: List all palaces with python scripts/palace_manager.py list
Best Practices
- Build a comprehensive spatial index across all palaces
- Choose the right modalities (spatial, semantic, sensory, associative, temporal) for the task
- Regularly map cross-references and verify link accuracy
- Run controlled retrieval tests to validate accuracy and speed
- Analyze usage patterns and tune search strategies for latency and accuracy
Example Use Cases
- Search for authentication related items across multiple palaces using semantic queries
- Cross-reference OAuth concepts across different palaces to surface connections
- Use spatial queries to locate concepts in the Workshop area of the palace network
- Review past PR decisions by querying the Review Chamber
- Identify recently accessed items with temporal queries to surface activity trends
Frequently Asked Questions
Related Skills
explorer
aiskillstore/marketplace
Quickly search and navigate the codebase - Use when you need to quickly find files, search for patterns, or locate specific code without deep analysis.
Agent Browser Automation
PramodDutta/qaskills
Fast Rust-based headless browser automation CLI with Node.js fallback for AI agents, featuring navigation, clicking, typing, snapshots, and structured commands optimized for agent workflows.
