Rules for agents

• For a known term, start with a bounded search such as grep -n -i -C2 "term" file | head.
• Use query when you do not know the exact wording or a plain search returns too many matches.
• Use -k 1 or -k 2 for a single fact. Add --language <lang> to match related word forms.
• Build an index with --emit-index only when you expect several queries over the same file.

Query a document

Search an extracted Markdown or text file and return the most relevant line ranges. The command reads the local file; it does not parse PDFs.

Related skills

• pdf-to-markdown — converts a PDF to structured Markdown.
• pdf-to-text — converts a PDF to plain text while preserving columns and spacing.

Usage

Set SKILL_DIR to the absolute path of the directory containing this file. Use $SKILL_DIR/bin/query in the commands below.