Skip to content

Solizardking/clawd-bot / .agents/skills/golang-pkg-go-dev

golang-pkg-go-dev

Verified

Golang package and module documentation and exploration via `godig`, a pkg.go.dev API client (CLI + MCP server) — package docs, API references, symbols, code examples, available versions, importers (who imports a package), licenses, and known vulnerabilities. Read-only, no auth. Use for looking up any Go/Golang library's documentation, API signatures, usage examples, which versions exist, whether a dependency has CVEs, or who imports a package — prefer this over Context7 for any Go package or module. Triggers on: how to use a Go library, Go API docs, import usage, code examples, pkg.go.dev. Not for upgrading dependencies (→ See `samber/cc-skills-golang@golang-dependency-management` skill) or choosing a library (→ See `samber/cc-skills-golang@golang-popular-libraries` skill). Not for local symbols, or for navigating an already-used dependency's resolved source, call sites, or generic instantiations — → See `samber/cc-skills-golang@golang-gopls` skill for those.

FileKindSize
SKILL.mdskill md12.2 KB
references/sample-output.mdmarkdown6.6 KB

references/sample-output.md

View on GitHub
# godig sample output

Representative `-o md` output for each command, captured against `godig` v0.2.0. Empty cells are shown as `—`. Field sets mirror the underlying APIs — pkg.go.dev for most commands, the Go vulnerability database (`vuln.go.dev`, OSV) for `vulns` — and may grow over time.

## overview

`godig overview github.com/samber/ro -o md`

| field             | value                          |
| ----------------- | ------------------------------ |
| isStandardLibrary | false                          |
| latestVersion     | v0.3.0                         |
| licenses          | ["Apache-2.0"]                 |
| modulePath        | github.com/samber/ro           |
| name              | ro                             |
| path              | github.com/samber/ro           |
| recentVersions    | ["v0.3.0","v0.2.0","v0.1.0"]   |
| repoUrl           | <https://github.com/samber/ro> |

## search

`godig search ro --limit 3 -o md`

| modulePath | packagePath | synopsis | version |
| --- | --- | --- | --- |
| github.com/samber/ro | github.com/samber/ro | — | v0.3.0 |
| github.com/blevesearch/bleve | github.com/blevesearch/bleve/analysis/lang/ro | — | v1.0.14 |
| github.com/blevesearch/bleve/v2 | github.com/blevesearch/bleve/v2/analysis/lang/ro | — | v2.6.0 |

## package info

`godig package info github.com/samber/ro -o md`

| field             | value                |
| ----------------- | -------------------- |
| goarch            | all                  |
| goos              | all                  |
| isLatest          | true                 |
| isRedistributable | true                 |
| isStandardLibrary | false                |
| modulePath        | github.com/samber/ro |
| name              | ro                   |
| path              | github.com/samber/ro |
| version           | v0.3.0               |

## package imports

`godig package imports github.com/samber/ro -o md` — a plain list (no `--limit`):

```text
- context
- errors
- fmt
- ...
```

## versions

`godig versions github.com/samber/ro --limit 3 -o md`

| commitTime | deprecated | deprecationReason | hasGoMod | isRedistributable | latestVersion | modulePath | retracted | retractionReason | version |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 2026-03-02T15:16:08Z | false | — | true | true | v0.3.0 | github.com/samber/ro | false | — | v0.3.0 |
| 2025-10-25T22:20:38Z | false | — | true | false | v0.3.0 | github.com/samber/ro | false | — | v0.2.0 |
| 2025-10-14T12:21:03Z | false | — | true | false | v0.3.0 | github.com/samber/ro | false | — | v0.1.0 |

## major-versions

`godig major-versions github.com/samber/lo -o md`

| isLatest | major | modulePath           | version |
| -------- | ----- | -------------------- | ------- |
| true     | v1    | github.com/samber/lo | v1.53.0 |

## imported-by

`godig imported-by github.com/samber/ro --limit 3 -o md`

| package                                |
| -------------------------------------- |
| github.com/CooperCorona/websocket      |
| github.com/CooperCorona/websocket/test |
| github.com/samber/ro/ee/plugins/otel   |

## vulns

`godig vulns github.com/dgrijalva/jwt-go -o md`

Since v0.2.0 `vulns` reads the Go vulnerability database (`vuln.go.dev`, OSV) directly, so `summary` and per-range fix versions are populated (they were empty when sourced from pkg.go.dev). `fixedVersion` is gone — fixed/introduced versions now live in `ranges`; new `aliases`, `packages` and `references` fields are also returned.

| aliases | details | id | ranges | summary |
| --- | --- | --- | --- | --- |
| ["CVE-2020-26160","GHSA-w73w-5m7g-f7qc"] | If a JWT contains an audience claim with an array of strings ... | GO-2020-0017 | [{"introduced":"0.0.0-20150717181359-44718f8a89b0"}] | Authorization bypass in github.com/dgrijalva/jwt-go |

`vulns` returns an empty list when a module has no known vulnerabilities. `--filter` and `--module` no longer apply to `vulns`; only `--version` and `--limit` do.

## dependencies

`godig dependencies github.com/samber/ro -o md` — one section per go.mod block (`requires`, `replaces`, `excludes`, `go` directive):

```markdown
## requires

| path                       | version | indirect |
| -------------------------- | ------- | -------- |
| github.com/samber/lo       | v1.52.0 | —        |
| github.com/davecgh/go-spew | v1.1.1  | true     |
```

## module info

`godig module info github.com/samber/ro -o md`

| field             | value                          |
| ----------------- | ------------------------------ |
| commitTime        | 2026-03-02T15:16:08Z           |
| goVersion         | 1.18                           |
| hasGoMod          | true                           |
| isLatest          | true                           |
| isRedistributable | true                           |
| isStandardLibrary | false                          |
| path              | github.com/samber/ro           |
| repoUrl           | <https://github.com/samber/ro> |
| size              | 137530                         |
| version           | v0.3.0                         |

## packages

`godig packages github.com/samber/ro --limit 4 -o md`

| isRedistributable | name | path | synopsis |
| --- | --- | --- | --- |
| true | ro | github.com/samber/ro | — |
| true | constraints | github.com/samber/ro/internal/constraints | — |
| true | xatomic | github.com/samber/ro/internal/xatomic | — |
| true | xerrors | github.com/samber/ro/internal/xerrors | — |

## symbols

`godig symbols github.com/samber/ro --limit 4 -o md`

| kind     | name              | parent          | synopsis                  |
| -------- | ----------------- | --------------- | ------------------------- |
| Type     | Backpressure      | Backpressure    | type Backpressure int8    |
| Constant | BackpressureBlock | Backpressure    | const BackpressureBlock   |
| Constant | BackpressureDrop  | Backpressure    | const BackpressureDrop    |
| Type     | ConcurrencyMode   | ConcurrencyMode | type ConcurrencyMode int8 |

## symbol doc

`godig symbol doc github.com/samber/lo Map -o md` — token-efficient vs `package doc`:

| field | value |
| --- | --- |
| goarch | all |
| goos | all |
| kind | Function |
| name | Map |
| path | github.com/samber/lo |
| signature | func Map[T, R any](collection []T, transform func(item T, index int) R) []R |
| synopsis | Map manipulates a slice and transforms it to a slice of another type. |
| version | v1.53.0 |

## Raw / large output

`package doc`, `package examples`, `symbol examples` and `module readme` return raw Markdown (use `-o md` or `-o raw`), e.g.:

```markdown
# package ro

## Constants

...
```

`package licenses` and `module licenses` return the full license text.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall