Skip to main contentresearch-library
Local-first multimedia research library for hardware projects. Capture code, CAD, PDFs, images. Search with material-type weighting. Project isolation with cross-references. Async extraction. Backup + restore.
설치로 이동 Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/johnalbertini14-glitch/openclaw-skills --skill research-library명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
| name | research-library |
| description | Local-first multimedia research library for hardware projects. Capture code, CAD, PDFs, images. Search with material-type weighting. Project isolation with cross-references. Async extraction. Backup + restore. |
| version | 0.1.0 |
| author | Sage (for Jon Buckles) |
| license | MIT |
| tags | ["knowledge-management","research","hardware","documentation","sqlite","fts5"] |
| repository | https://github.com/[user]/research-library |
| keywords | ["library","search","extraction","project-management","knowledge-base"] |
Research Library Skill
A local-first multimedia research library for capturing, organizing, and searching hardware project knowledge.
What It Does
- Store documents — Code, PDFs, CAD files, images, schematics
- Extract automatically — Text from PDFs, EXIF from images, functions from code
- Search intelligently — Full-text with material-type weighting (your work ranks higher than external research)
- Project isolation — Arduino separate from CNC; no contamination
- Cross-reference — Link knowledge: "this servo tuning applies to that project"
- Async extraction — Searches never block while OCR runs
- Backup daily — 30-day rolling snapshots
Installation
clawhub install research-library
pip install /path/to/research-library
Quick Start
reslib status
reslib add ~/projects/arduino/servo.py --project arduino --material-type reference
reslib search "servo tuning"
reslib link 5 12 --type applies_to
Features
CLI Commands
reslib add — Import documents (auto-detect + extract)
reslib search — Full-text search with filters
reslib get — View document details
reslib archive / reslib unarchive — Manage documents
reslib export — Export as JSON/Markdown
reslib link — Create document relationships
reslib projects — Manage projects
reslib tags — Manage tags
reslib status — System overview
reslib backup / reslib restore — Snapshots
reslib smoke_test.sh — Quick validation
Technical
- SQLite 3.45+ with FTS5 virtual table
Storage:
Extraction: PDF (pdfplumber + OCR), images (EXIF + OCR), code (AST + regex)Confidence Scoring: 0.0-1.0 based on quality + sourceMaterial Weighting: Reference (1.0) vs Research (0.5)Project Isolation: Scoped searches, no contaminationAsync Workers: 2-4 configurable extraction workersCatalog Separation: real_world vs openclaw projectsBackup: Daily snapshots, 30-day retentionConfiguration
Copy reslib/config.json and customize:
{
"db_path": "~/.openclaw/research/library.db",
"num_workers": 2,
"worker_timeout_sec": 300,
"max_retries": 3,
"backup_retention_days": 30,
"backup_dir": "~/.openclaw/research/backups",
"file_size_limit_mb": 200,
"project_size_limit_gb": 2
}
Integration with War Room
Use RL1 protocol in war room DNA:
from reslib import ResearchDatabase, ResearchSearch
db = ResearchDatabase()
search = ResearchSearch(db)
prior = search.search("servo tuning", project="rc-quadcopter")
if prior:
print(f"Found {len(prior)} prior items")
else:
db.add_research(title="...", content="...", ...)
Performance
| Operation | Target | Actual |
|---|
| PDF extraction | <100ms | 20.6ms |
| Search (50 docs) | <100ms | 0.33ms |
| Worker throughput | >6/sec | 414.69/sec |
Testing
pytest tests/
bash reslib/smoke_test.sh
pytest tests/test_integration.py -v -k stress
Known Limitations (Phase 2)
- OCR quality varies on hand-drawn sketches
- FTS5 designed for <10K documents (PostgreSQL path for scale)
- No automatic web research gathering (manual only)
- Vector embeddings ready but inactive
- CAD file parsing is metadata-only
Documentation
CLI-REFERENCE.md — All commands + examples
EXTRACTION-GUIDE.md — How extraction works
SEARCH-GUIDE.md — Ranking + weighting
WORKER-GUIDE.md — Async queue details
INTEGRATION.md — War room RL1 protocol
Phase 2 Roadmap
- Real-world PDF calibration
- FTS5 scaling tests (10K docs)
- Auto-detection (reference vs research)
- Web research enrichment
- Vector embeddings (semantic search)
- PostgreSQL upgrade path
Building From Source
cd research-library
pip install -e .
pytest tests/
python -m reslib status
Support
Issues? See TECHNICAL-NOTES.md for troubleshooting.
Production-ready MVP. 214 tests passing. 15K lines. Ready to use.