# AQuA Agent Quality

Adds the AQuA quality agent to an agents-cli project and reads its insights.

- Repository: https://github.com/google/adk-recipes (10565 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add google/adk-recipes --skill agents-cli-aqua -g -a claude-code -y`
Codex: `npx skills add google/adk-recipes --skill agents-cli-aqua -g -a codex -y`
Cursor: `npx skills add google/adk-recipes --skill agents-cli-aqua -g -a cursor -y`
Gemini CLI: `npx skills add google/adk-recipes --skill agents-cli-aqua -g -a gemini-cli -y`

## Description

Work with the Ambient Quality Agent (AQuA) added to this agents-cli project: augment the agents-cli agent with AQuA or attach the agent to an AQuA deployed elsewhere, read the quality insights it finds in production conversations, get AQuA's root-cause diagnosis, read what the developer asked it to remember, and fix the defects in the agent's code. Propose proactively when the user mentions AQuA or AQA, wants to monitor the quality of a deployed agent, mentions traces or observability, asks what is going wrong with their agent in production, wants to fix AQuA insights, or wants to publish code metrics to AQuA. Don't use for offline evals of a local agent (use google-agents-cli-eval) or for deploys without AQuA (google-agents-cli-deploy).

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# AQuA with agents-cli

AQuA watches deployed agents, reviews their production conversations, and
records each distinct defect it finds as an **insight**. AQuA is deployed on
its own, and `agents-cli aqua attach` tells it which agent to watch and how
(see [Deploy AQuA on its own and attach the agent](#deploy-aqua-on-its-own-and-attach-the-agent)).
`agents-cli aqua` queries it. With the AQuA extension,
`agents-cli infra single-project --apply-aqua` and
`agents-cli deploy --deploy-aqua` can also provision and deploy AQuA beside the
agent; without those two flags, both commands work on the agent alone.

Run every command from the agent's project root, the directory with
`agents-cli-manifest.yaml`, or from AQuA's checkout if AQuA was deployed from
there. Query subcommands print one JSON document on stdout
and progress on stderr, so pipe stdout into `jq`.

When you start using this skill, always run `agents-cli aqua -- --help` to
discover AQuA's commands, and `agents-cli aqua <command> -- --help` for a
command's flags and the fields of its JSON output. Without the `--`, agents-cli
prints its own help instead. Two
commands are missing from that list: `agents-cli aqua info` (the
deployment record and dashboard URL, or one value with `--resource`,
`--region`, `--ui-service` or `--ui-url`) and `agents-cli aqua ui-proxy` (see
[Dashboard](#dashboard)).

## Vocabulary

The rest: https://github.com/google/adk-recipes/blob/HEAD/core/python/ambient-quality-agent/skills/agents-cli-aqua/SKILL.md