PKM Search Skill

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

1. Always run search first before claiming no results exist
2. Try multiple queries if initial search yields few results
3. Use Korean terms for better matches (most tags are in Korean)
4. Check the URL before sharing - all repos link to github.com
5. Summarize relevantly - don't just list all results, highlight the most relevant ones

Troubleshooting

If search returns no results:

1. Try simpler/shorter query
2. Try the Korean equivalent term
3. Remove filters and search broadly first
4. Check if index exists: ls data/index.json
5. Rebuild index if needed: python scripts/build_index.py --force