Documentation Discovery via Scripts
Overview
Script-first documentation discovery using llms.txt standard.
Execute scripts to handle entire workflow - no manual URL construction needed.
Primary Workflow
ALWAYS execute scripts in this order:
# 1. DETECT query type (topic-specific vs general)
node ~/.Codex/skills/docs-seeker/scripts/detect-topic.js "<user query>"
# 2. FETCH documentation using script output
node ~/.Codex/skills/docs-seeker/scripts/fetch-docs.js "<user query>"
# 3. ANALYZE results (if multiple URLs returned)
cat llms.txt | node ~/.Codex/skills/docs-seeker/scripts/analyze-llms-txt.js -
Scripts handle URL construction, fallback chains, and error handling automatically.
Scripts
detect-topic.js - Classify query type
- Identifies topic-specific vs general queries
- Extracts library name + topic keyword
- Returns JSON:
{topic, library, isTopicSpecific} - Zero-token execution
fetch-docs.js - Retrieve documentation
- Constructs context7.com URLs automatically
- Handles fallback: topic → general → error
- Outputs llms.txt content or error message
- Zero-token execution
analyze-llms-txt.js - Process llms.txt
- Categorizes URLs (critical/important/supplementary)
- Recommends agent distribution (1 agent, 3 agents, 7 agents, phased)
- Returns JSON with strategy
- Zero-token execution
Workflow References
Topic-Specific Search - Fastest path (10-15s)
General Library Search - Comprehensive coverage (30-60s)
Repository Analysis - Fallback strategy
References
context7-patterns.md - URL patterns, known repositories
errors.md - Error handling, fallback strategies
advanced.md - Edge cases, versioning, multi-language
Execution Principles
- Scripts first - Execute scripts instead of manual URL construction
- Zero-token overhead - Scripts run without context loading
- Automatic fallback - Scripts handle topic → general → error chains
- Progressive disclosure - Load workflows/references only when needed
- Agent distribution - Scripts recommend parallel agent strategy
Quick Start
Topic query: "How do I use date picker in shadcn?"
node ~/.Codex/skills/docs-seeker/scripts/detect-topic.js "<query>" # → {topic, library, isTopicSpecific}
node ~/.Codex/skills/docs-seeker/scripts/fetch-docs.js "<query>" # → 2-3 URLs
# Read URLs with WebFetch
General query: "Documentation for Next.js"
node ~/.Codex/skills/docs-seeker/scripts/detect-topic.js "<query>" # → {isTopicSpecific: false}
node ~/.Codex/skills/docs-seeker/scripts/fetch-docs.js "<query>" # → 8+ URLs
cat llms.txt | node ~/.Codex/skills/docs-seeker/scripts/analyze-llms-txt.js - # → {totalUrls, distribution}
# Deploy agents per recommendation
Environment
Scripts load .env: process.env > ~/.Codex/skills/docs-seeker/.env > ~/.Codex/skills/.env > .Codex/.env
See .env.example for configuration options.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.