doc-explorer

doc-explorer

Answers questions about Dart/Flutter packages by exploring version-accurate documentation generated from the project's actual dependencies.

Step 1: Prepare documentation

Run a Dart script at ${CLAUDE_SKILL_DIR}/scripts/prepare_documentation.dart to get the documentation locations for the packages you want to explore. Note that you must know the canonical package names. The script's usage is:

prepare_documentation.dart --project <path/to/dart/project/root> <package-name1> <package-name2> ...

IMPORTANT: Make sure to specify the path to the Dart/Flutter project root, which contains the pubspec.yaml file.

Then, read the JSON output:

{
  "packages": {
    "dio": {
      "documentation": "/Users/you/.pubdoc/cache/dio/dio-5.3.x"
    }
  },
  "error": null
}

IMPORTANT: If the script ends with an error, stop and ask the user how to proceed, rather than attempting to debug or recover on your own.

Step 2: Explore documentation

Spawn a subagent to delegate the exploration:

• Model: fast, low-latency
• Permissions: read-only
• Pass: the query, per-package documentation paths from step 1

If you can use a built-in read-only agent optimized for searching and analyzing codebases (e.g., Explore agent), use it here. If you cannot spawn a subagent, read and follow agents/doc-explorer.md yourself.

Always use this prompt template:

Read the package documentation and answer the query:

- Documentation: <documentation-path>
- Query: <describe what you want to know about the package>

Read and follow this for additional instructions: ${CLAUDE_SKILL_DIR}/agents/doc-explorer.md.

Wait for the findings, then use them to proceed with your task.

Note on documentation access

Rely on the subagent's findings — do not read the documentation yourself unless the subagent's report is insufficient and further reading is clearly needed.