pub-package-explorer

Original：🇺🇸 English

Translated

Find and read source code for Dart or Flutter package dependencies installed in a project. Use when asked to inspect code from a package on pub.dev, trace implementation details in dependencies, or locate package files from package names by resolving `.dart_tool/package_config.json`.

1installs

Sourceexaby73/skills

Added on2026-02-09

NPX Install

npx skill4agent add exaby73/skills pub-package-explorer

SKILL.md Content

View Translation Comparison →

Pub Package Explorer

Use this workflow to read source code for a dependency package in a Dart or Flutter project.

Resolve a Package Source Path

Confirm the project contains
```
.dart_tool/package_config.json
```
.
Read the package entry from
```
packages[]
```
by
```
name
```
.
Extract:

```
rootUri
```
(package root, usually in pub cache)
```
packageUri
```
(usually
```
lib/
```
)

Build source path as
```
rootUri + packageUri
```
.
Convert
```
file://
```
URI to a filesystem path before reading files.

Use this command pattern:

bash

PACKAGE="analyzer"
CONFIG=".dart_tool/package_config.json"

SOURCE_URI="$(jq -r --arg pkg "$PACKAGE" '
  .packages[]
  | select(.name == $pkg)
  | (.rootUri + (if (.rootUri | endswith("/")) then "" else "/" end) + .packageUri)
' "$CONFIG")"

Convert the URI to a local path:

bash

SOURCE_PATH="$(printf '%s\n' "$SOURCE_URI" | sed 's#^file://##')"

Then inspect source files under that directory (

rg

,

ls

,

cat

).

Useful Variants

Return only the package root:

bash

jq -r --arg pkg "$PACKAGE" '
  .packages[]
  | select(.name == $pkg)
  | .rootUri
' .dart_tool/package_config.json

Return both root and package URI:

bash

jq -r --arg pkg "$PACKAGE" '
  .packages[]
  | select(.name == $pkg)
  | "\(.rootUri)\t\(.packageUri)"
' .dart_tool/package_config.json

Verification and Error Handling

If no package matches, stop and report that the package is not in
```
package_config.json
```
.
If
```
.dart_tool/package_config.json
```
is missing, run dependency resolution first (
```
dart pub get
```
or
```
flutter pub get
```
) and retry.
Prefer reading from
```
rootUri + packageUri
```
because package APIs are exposed from that subpath, not always from the package root.

pub-package-explorer

NPX Install

Tags

SKILL.md Content

Pub Package Explorer

Resolve a Package Source Path

Useful Variants

Verification and Error Handling