# gcql-advanced

> Claude/Codex skill by [@groundcover-com](https://omgskills.com/library/groundcover-com/index.md) · 0 stars · Updated 2026-09-09

Compose non-simple gcQL for groundcover's read-only public query tools. Use for multi-pipe queries, grouped aggregations, multiple aggregations, math, joins or subqueries, post-aggregation filters, count\_all\_result, or gcQL embedded in monitor and dashboard analysis.

## Install

```sh
git clone https://github.com/groundcover-com/claude-plugin-groundcover /tmp/claude-plugin-groundcover && ln -s /tmp/claude-plugin-groundcover/skills/gcql-advanced ~/.claude/skills/gcql-advanced
```

## From README

Advanced gcQL Use the server's live reference to compose complex gcQL. Do not rely on a memorized or copied syntax reference: supported operators, arguments, and examples can change with the connected groundcover backend. Load the live reference Resolve the backend and workspace with listworkspaces. If multiple plausible choices remain, ask the user instead of guessing. Record the selected tenantuuid and backendid, and pass them to every subsequent tool call whose live schema accepts them; the server is stateless, so a selection made for one call does not carry into the next. Treat querymetrics and querymonitors like other routed tools. When their live schemas expose tenantuuid and backendid, pass the selected values explicitly, especially when the account exposes multiple choices. Call getgcqlreference before composing the first gcQL query in a session. Treat its basic and advanced sections as authoritative. Inspect the live schema for the relevant query tool.

## Links

- HTML page: https://omgskills.com/library/groundcover-com/claude-plugin-groundcover/skills/gcql-advanced/
- GitHub: https://github.com/groundcover-com/claude-plugin-groundcover
- Author: [@groundcover-com](https://omgskills.com/library/groundcover-com/index.md)

## More from this repo

- [discovery](https://omgskills.com/library/groundcover-com/claude-plugin-groundcover/skills/discovery/index.md) — Discover groundcover fields, values, entities, metrics, and signal shape before writing a precise read-only query.
   - [@groundcover-com](https://omgskills.com/library/groundcover-com/index.md) · 0 stars