version: "1.0.1" description: > Search machine manuals, bearing catalogs, and technical documentation using RAG-based retrieval via the predictive-maintenance-mcp server. Use this skill when the user says "search documentation", "find in manual", "bearing catalog", "look up bearing", "machine manual", "extract specs", "find bearing specs", "SKF bearing", "technical documentation", "datasheet", "manual search", "what bearing", or needs to find technical information from stored documents.

Documentation Search

Search and extract information from machine manuals, bearing catalogs, and technical datasheets using RAG-based retrieval (FAISS + TF-IDF) and structured document parsing.

Prerequisite: The predictive-maintenance-mcp MCP server must be connected.

Core Operations

List Available Documentation

Call list_machine_manuals() to see all manuals and catalogs available in the resources/ directory (PDF, TXT formats), with their file names.

Search Across All Documents (RAG)

Call search_documentation(query="bearing replacement procedure", top_k=5) for semantic search across all indexed documents.

• query: natural-language search (e.g. "maximum vibration limits")
• top_k: number of passages to return (default 5)
• force_reindex: set True only if documents changed since the last search

Read Manual Excerpts

Call read_manual_excerpt(file_name="test_pump_manual.pdf", max_pages=10) to read the first pages of a manual (up to max_pages). Use the file_name exactly as returned by list_machine_manuals.

Extract Machine Specifications

Call extract_manual_specs(file_name="test_pump_manual.pdf") to pull structured data from a manual:

• Bearing designations and types
• Power ratings and RPM ranges
• Vibration limits
• Maintenance intervals

Look Up a Bearing in the Catalog

Call search_bearing_catalog(bearing_id="6205").

• Accepts designations like "6205" or "SKF 6205-2RS" (prefixes resolved)
• Returns verified geometry (number of balls, ball diameter, pitch diameter,

contact angle) WITH its source citation, plus fault-frequency multipliers (BPFO/BPFI/BSF/FTF per unit of shaft speed)

• The catalog contains only entries with physically valid, source-traced

geometry. A miss returns a structured "not found" result with a suggestion — never invented geometry. In that case ask the user for the geometry and use calculate_bearing_characteristic_frequencies(num_balls=9, ball_diameter_mm=7.94, pitch_diameter_mm=39.04, contact_angle_deg=0.0, rpm=1797).

Typical Workflows

"What bearing is installed in this machine?"

1. list_machine_manuals() to find the relevant manual
2. extract_manual_specs(file_name="<manual>.pdf") to pull bearing designations
3. search_bearing_catalog(bearing_id="<designation>") for verified geometry

"Find the vibration limits for this equipment"

1. search_documentation(query="vibration limits <machine name>")
2. If insufficient, read_manual_excerpt(file_name="<manual>.pdf", max_pages=10)

"Look up bearing 6205 and check the signal against it"

1. search_bearing_catalog(bearing_id="6205") — geometry + frequency multipliers
2. check_bearing_faults(signal_id="<id>", rpm=1797, bearing_id="6205") —

computes BPFO/BPFI/BSF/FTF at the given RPM and matches them against the signal's envelope spectrum in one call

Important Notes

• The RAG index is built on first search and cached for later queries
• PDF extraction quality depends on document formatting
• The bearing catalog is deliberately small and verified — every entry has a

source field. Uncommon bearings need user-provided geometry; the tools will say so rather than guess

• Documentation findings inform the engineer's decision — verify critical

specs against the physical nameplate when possible

• All documents are processed locally — no data leaves the machine