Fetch Documentation

Fetch and cache documentation for a specified library, creating a local snapshot in ~/.claude/docs for accurate, version-specific AI context.

Current Context

• Current working directory: !pwd

Your Task

When the user invokes this command, follow these steps:

1. Parse Arguments: The user provided: $ARGUMENTS
   • First argument is the library name (required)
   • Second argument is optional version (e.g., "15.0.0")
   • Optional --url flag for custom documentation URLs
   • If library is missing: prompt for the library name

1.5. INSTALL DEPENDENCIES: If ~/.claude/plugins/cache/doc-fetcher/node_modules doesn't exist then execute cd ~/.claude/plugins/cache/doc-fetcher && npm install after installation change the directory back to the project workspace root.

2. Run Fetch Command:

   • Execute: node ~/.claude/plugins/cache/doc-fetcher/scripts/fetch-docs.js $ARGUMENTS
   • The script will:
     • Discover documentation format (llms.txt, claude.txt, or sitemap.xml)
     • Detect the documentation framework (Docusaurus, VitePress, Nextra, etc.)
     • Crawl and cache pages to ~/.claude/docs/[library]/[version]/
     • Respect robots.txt and rate limits
     • Save metadata in index.json and structure in sitemap.json
   • Monitor progress and show status to the user

3. Handle Results:

   • If successful: Report:
     • Number of pages fetched
     • Storage location (~/.claude/docs/[library]/[version]/)
     • Total size
     • Whether a skill was auto-generated
   • Show next steps (how to use the cached docs or generate a skill)

4. Error Handling:

   • If URL not found (404): Verify the library name or try --url flag with custom URL
   • If network errors: Suggest retrying or checking connection
   • If rate limited: Suggest increasing crawl_delay_ms in doc-fetcher-config.json
   • If documentation too large (>500 pages): Inform user and ask if they want to continue
   • If framework not detected: Suggest using --url with the docs homepage
   • If script not found: Verify the doc-fetcher plugin is installed

5. Skill Generation: If auto_generate_skills: true in config, inform the user that a skill was automatically created and how to use it.

Important Notes

• The script runs from the plugin directory: ~/.claude/plugins/cache/doc-fetcher/
• Documentation is cached globally in ~/.claude/docs and shared across all projects
• The cache directory is configured in doc-fetcher-config.json and defaults to ~/.claude/docs
• Fetching can take several minutes for large documentation sets
• Use specific versions (e.g., /fetch-docs nextjs 15.0.0) to match your project's package.json
• The fetched docs are stored locally and won't be updated automatically (use /update-docs for that)