CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agents-cli-aqua

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).

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

85%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exceptionally actionable, well-validated operational manual whose only structural weakness is that it is monolithic: all deploy, attach, dashboard, and ops detail is inlined in SKILL.md with no progressive disclosure to reference files.

Suggestions

Split rarely-needed detail into one-level-deep reference files (e.g., references/attach.md for the four attach variants, references/dashboard.md for IAP vs ui-proxy access) and keep SKILL.md as an overview that links to them — this serves both progressive_disclosure and the always-loaded token budget.

Remove the duplicated detach and list-memories guidance between the Attach/Fix sections and the "Other tasks" table by cross-referencing one canonical location.

Consider moving the deploy Failure/Fix table next to the validation step it supports (or into a reference), so the main deploy sequence stays scannable while recovery paths remain discoverable.

DimensionReasoningScore

Conciseness

Dense and product-specific throughout — no explanations of concepts Claude already knows, and every section carries non-obvious operational detail (exit-code semantics, lookback-window gotchas, Terraform state locations). Kept from 5 by minor repetition: detach and list-memories are each restated in both the workflow sections and the "Other tasks" table rather than cross-referenced. Not 3 because there is no padded or over-explained section.

4 / 5

Actionability

Fully executable guidance throughout: copy-paste-ready bash for every operation ("agents-cli aqua list-insights | jq '.insights[] | select(.status != \"RESOLVED\") ...'", the bq traffic-check query, the gcloud IAP binding command), exact flags, field names, and expected outputs ("expect exit 0 with counters.traces_scanned above zero").

5 / 5

Workflow Clarity

Multi-step workflows with explicit validation checkpoints: deploy confirms the agent-name match before applying ("A mismatch raises no error"), confirms traffic with a concrete bq query plus a schedule-investigation expecting traces_scanned > 0, a Failure/Fix table gives recovery loops, and destructive or billable operations (attach --apply, destroy, --apply-aqua --apply) are gated behind plans, --dry-run, and explicit user go-aheads. The fix workflow ends with post-deploy verification guidance (judge by conversation timestamps, not occurrence counts).

5 / 5

Progressive Disclosure

Well-sectioned with working internal anchor links, but the skill is a single ~380-line file with no references/ bundle: dashboard IAM/IAP grant details, four attach command variants, and the ops table are all inlined in the always-loaded SKILL.md when they belong in one-level-deep reference files (anchor 3: "content that should be separate is inline"). Not 4 because there are no reference files at all and rarely-needed detail (e.g., attach-from-any-directory variants) sits in the main file; not 2 because the section structure and navigation are clear, not buried.

3 / 5

Total

17

/

20

Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete third-person actions, explicit proactive-trigger and exclusion clauses, and a distinct niche. The only weakness is the slightly over-broad "traces or observability" trigger term.

DimensionReasoningScore

Specificity

Lists six concrete actions in third-person imperative voice ("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", "fix the defects in the agent's code") with comprehensive coverage of the skill's scope.

5 / 5

Completeness

Explicitly answers both what (the enumerated action list) and when ("Propose proactively when the user mentions AQuA or AQA, ...") with concrete trigger phrases, and adds negative triggers ("Don't use for offline evals of a local agent (use google-agents-cli-eval) or for deploys without AQuA (google-agents-cli-deploy)").

5 / 5

Trigger Term Quality

Natural phrases users would actually say ("mentions AQuA or AQA", "wants to monitor the quality of a deployed agent", "asks what is going wrong with their agent in production", "mentions traces or observability", "wants to publish code metrics to AQuA") including the AQuA/AQA synonym pair. No first/second-person voice penalty applies.

5 / 5

Distinctiveness Conflict Risk

A clear niche (the AQuA product) with explicit redirects to sibling skills, but the broad trigger "mentions traces or observability" could pull this skill in for generic tracing/observability requests unrelated to AQuA — minor overlap risk with closely related tooling rather than the minimal risk of the top anchor.

4 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

Total

15

/

16

Passed

Repository

google/adk-samples

Path

core/python/ambient-quality-agent/skills/agents-cli-aqua/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.