1---
 2name: querying-documentation
 3description: Spawns a focused subagent to query language/framework documentation. Use for complex questions requiring exploration across multiple symbols, external library APIs, or understanding how to combine types from different packages. Currently supports Go; more doc sets may be added later.
 4compatibility: Requires Fish and synu Fish plugin
 5license: AGPL-3.0-or-later
 6metadata:
 7  author: Amolith <amolith@secluded.site>
 8---
 9
10Invoke with `fish path/to/skills/querying-documentation/scripts/query.fish -s <set> '<query>'`. Use the absolute path so you can run it from the project directory where `go doc` will work.
11
12Run with `-h` to see available doc sets.
13
14These agents have restricted tool access—they can only query docs, not read files or search the web. Write thorough questions that justify the cost; simple lookups you can answer with `go doc` yourself.
15
16## Examples
17
18```bash
19# Combining stdlib with external library
20fish path/to/skills/querying-documentation/scripts/query.fish -s go 'How would I use golang.org/x/sync/errgroup together with context.WithCancel to run parallel HTTP requests that all cancel if any fails?'
21
22# Understanding relationships across an external library
23fish path/to/skills/querying-documentation/scripts/query.fish -s go 'In github.com/charmbracelet/bubbletea, how do Model, Cmd, and Msg relate? What does Update return and why?'
24
25# Exploring implementation patterns
26fish path/to/skills/querying-documentation/scripts/query.fish -s go 'How do the io.Reader wrappers (bufio.Reader, io.LimitReader, io.TeeReader) compose? Show how to chain them for reading a limited, buffered copy of a stream.'
27```
28
29---
30
31Refer to [dependencies.md](references/dependencies.md) if dependencies are missing.