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 scripts/detect-topic.js "<user query>"
2. FETCH documentation using script output
node scripts/fetch-docs.js "<user query>"
3. ANALYZE results (if multiple URLs returned)
cat llms.txt | node 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 scripts/detect-topic.js "<query>" # → {topic, library, isTopicSpecific} node scripts/fetch-docs.js "<query>" # → 2-3 URLs
Read URLs with WebFetch
General query: "Documentation for Next.js"
node scripts/detect-topic.js "<query>" # → {isTopicSpecific: false} node scripts/fetch-docs.js "<query>" # → 8+ URLs cat llms.txt | node scripts/analyze-llms-txt.js - # → {totalUrls, distribution}
Deploy agents per recommendation
Environment
Scripts load .env : process.env
.claude/skills/docs-seeker/.env .claude/skills/.env .claude/.env
See .env.example for configuration options.