user-corpus-explorer

Index user-provided documents into a local AGENTS.md reference library.

32|1|Updated May 19, 2026
One-click install
npx skills add https://github.com/woodfishhhh/EZ_math_model --skill user-corpus-explorer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: user-corpus-explorer
Source: https://github.com/woodfishhhh/EZ_math_model/tree/main/skills/ez-math-model/tools/user-corpus-explorer
Command: npx skills add https://github.com/woodfishhhh/EZ_math_model --skill user-corpus-explorer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When you provide your own papers, notes, PDFs, datasets, or examples, it can be hard for a multi-stage agent to reliably find and cite the most relevant material without manually summarizing everything.

Core Features & Use Cases

  • Corpus-aware indexing: Recursively scans external/user-corpus/ and builds a local AGENTS.md reference index plus a JSON inventory for downstream planning.
  • File-type aware extraction: Reads full text for text/markdown, extracts text for DOCX, and performs PDF parsing with fallbacks while limiting very large reads for cost control.
  • Safe, pipeline-friendly output: Overwrites external/user-corpus/AGENTS.md each run, does not block the main pipeline on failure, and avoids uploading full documents to external services.

Quick Start

Use user-corpus-explorer near the end of EZ_math_model intake to scan your folder external/user-corpus/ and generate external/user-corpus/AGENTS.md and .corpus_index.json.

Frequently Asked Questions about user-corpus-explorer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a searchable reference index from my own PDFs and notes for math modeling?

To build a reference index from PDFs and notes, place your files in the external/user-corpus directory. The skill recursively scans the folder, extracts text from PDFs and DOCX files, and generates an AGENTS.md reference library for your math modeling pipeline.

What is the best way to extract text from PDF documents into a local knowledge base?

The best way to extract text from PDFs into a local knowledge base is using file-type aware extraction with parsing fallbacks. This skill reads full text from markdown and DOCX files while applying truncation to large PDFs to control processing costs.

Can I use document indexing to find relevant papers and limitations for my modeling workflow?

Yes, document indexing creates a searchable local reference source of recommendations and limitations. By generating a JSON inventory alongside AGENTS.md, downstream agents can reliably query your user corpus to find relevant papers and examples.

Does the corpus indexing process upload my full documents to external services?

No, the corpus indexing process avoids uploading full documents to external services. It safely builds a local reference index and overwrites the external/user-corpus/AGENTS.md file during each run without blocking the main pipeline on failure.

What are the limitations of recursive file scanning when processing a large user corpus?

A limitation of recursive file scanning is handling very large files, which are truncated to control costs. The process applies file-type specific exclusions and parsing fallbacks, but extremely large PDFs may not be fully extracted into the reference index.