tomevault-io PKM Search Skill
You are now enhanced with the PKM (Personal Knowledge Management) search capability for TechPKM.
What This Skill Does
This skill searches through 1000+ curated GitHub repository summaries in TechPKM. Each repo has been analyzed and summarized in Korean with metadata including:
- Programming language
- Tags (in Korean)
- Aliases
- Concise summary
When to Use
Automatically activate when users:
- Ask about GitHub repositories or open-source tools
- Request library/framework recommendations
- Search for specific technical implementations
- Use phrases like "깃헙", "프로젝트", "라이브러리", "레포"
- Ask about AI/ML tools, frameworks, or implementations
How to Search
Basic Search
cd /Users/imgeunseog/Documents/Github/TechPKM/.claude/skills/pkm
python scripts/search.py "<query>"
With Filters
# Filter by language
python scripts/search.py "langchain" --language Python
# Filter by tags (comma-separated)
python scripts/search.py "RAG" --tags "오픈소스,LLM"
# Limit results
python scripts/search.py "embedding" --limit 5
# JSON output for programmatic use
python scripts/search.py "agent" --json
Combined Example
python scripts/search.py "자연어처리" --language Python --tags "LLM" --limit 10
Search Features
1. Fuzzy Matching
Tolerates typos: "langchan" → finds "langchain"
2. Korean/English Translation
Automatically expands queries:
- "NLP" → also searches "자연어처리"
- "딥러닝" → also searches "deep learning"
- "RAG" → also searches "검색 증강 생성"
3. Scoring System
Results ranked by relevance (0-100):
- Exact repo name match: +100
- Alias match: +80
- Exact tag match: +60
- Partial tag match: +40
- Summary contains query: +30
- Fuzzy similarity: up to +25
Index Management
Rebuild Index (if needed)
python scripts/build_index.py
The index auto-detects changes:
- New files added to
/github/ - Modified files
- Deleted files
Force rebuild:
python scripts/build_index.py --force
Response Format
When presenting results, use this format:
## PKM Search Results: "<query>"
X repositories found:
### 1. owner/repo-name
**Language**: Python | **Score**: 95/100
**Tags**: Tag1, Tag2, Tag3
**URL**: https://github.com/owner/repo
> Summary of the repository's purpose and capabilities...
### 2. ...
Example Interactions
User: "langchain 대안 뭐 있어?" Action: Search for "langchain" and related frameworks
User: "RAG 구현할 때 쓸만한 Python 라이브러리"
Action: python scripts/search.py "RAG" --language Python --limit 10
User: "음성 인식 오픈소스"
Action: python scripts/search.py "음성 인식" (will also find "speech recognition")
User: "Find TypeScript AI agent frameworks"
Action: python scripts/search.py "AI agent" --language TypeScript
Important Notes
- Always run search first before claiming no results exist
- Try multiple queries if initial search yields few results
- Use Korean terms for better matches (most tags are in Korean)
- Check the URL before sharing - all repos link to github.com
- Summarize relevantly - don't just list all results, highlight the most relevant ones
Troubleshooting
If search returns no results:
- Try simpler/shorter query
- Try the Korean equivalent term
- Remove filters and search broadly first
- Check if index exists:
ls data/index.json - Rebuild index if needed:
python scripts/build_index.py --force
Converted and distributed by TomeVault — claim your Tome and manage your conversions.