Agent skill · DevOps · google

cloud-trace-querying agent skill by google

Queries Cloud Trace spans, filters by latency or error status, correlates distributed traces with Cloud Logging, and diagnoses latency bottlenecks across Google Cloud services.

View on GitHub Read SKILL.md

At a glance

Publisher	Google Official
Repository	google/skills (163 listed skills)
Category	DevOps and Cloud
License	Apache-2.0
Last commit	October 16, 2026 (repository)
SKILL.md	125 lines, 731 words
Bundled files	89 files, including references, scripts, assets or templates
Quality score	89/100 · B Passes all seven graded checks
Security scan	Not scanned
README badge	Get the badges for this listing

Before you install

Read from the skill's files at the directory's October 19, 2026 snapshot: what ships with it, what its code reads, and the terms it is published under.

Bundled scripts: 47 script files (33 Python, 14 Shell). Your agent may run them, so read them first.
Network: its scripts use an HTTP client or a cloud SDK, and name console.cloud.google.com, www.googleapis.com, observability.googleapis.com and logging.googleapis.com.
License: Apache-2.0, an open-source or open-content license.

Install cloud-trace-querying

The skills CLI works with Claude Code, Codex, Cursor and other agents; the other routes copy the folder by hand.

Skills CLI

npx skills add https://github.com/google/skills/tree/main/skills/cloud/cloud-trace-querying

Claude Code, project-level copy

tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/google/skills.git "$tmp/repo"
mkdir -p .claude/skills
cp -R "$tmp/repo/"skills/cloud/cloud-trace-querying .claude/skills/
rm -rf "$tmp"

Codex installer

python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
    --repo google/skills \
    --path skills/cloud/cloud-trace-querying

google/skills is third-party code. Read SKILL.md and any bundled scripts before you install it.

How the author describes it

Query Cloud Trace spans, filter by latency thresholds or error status, correlate distributed traces with Cloud Logging, and diagnose latency bottlenecks across Google Cloud services. Use when investigating slow requests, analyzing trace hierarchies, or resolving latency regressions. Do NOT use for querying non-GCP telemetry or database query optimization outside Cloud Trace.

From the description field of SKILL.md. Agents read this line to decide when to load the skill.

Sections in SKILL.md

Prerequisites & Setup
Quickstart Workflows
1. Identify Google Cloud Project ID
2. Search Traces (Latency & Errors)
3. Fetch Entire Trace Hierarchy
4. Fetch Correlated Application Logs
5. Fetch Specific Trace Span
6. Generate Cloud Console Deep Links
7. Format Output
8. Upstream Service Error Handling
Reference Documentation
Operational Workflows
Query Syntax & Tools
Semantic Conventions
Concepts & Architecture
Templates & Assets

Files in the skill folder

SKILL.md
assets/formatting/a2ui/single_span/display.a2ui.json
assets/formatting/a2ui/trace_chart/display.a2ui.json
assets/formatting/a2ui/trace_flow/display.a2ui.json
assets/formatting/a2ui/traces_heat_map/display.a2ui.json
assets/formatting/ascii/single_span/display.txt
assets/formatting/ascii/trace_chart/display.txt
assets/formatting/ascii/trace_flow/display.txt
assets/formatting/ascii/traces_heat_map/display.txt
assets/queries/billing_errors/SCENARIO.md
assets/queries/billing_errors/query.txt
assets/queries/checkout_latency/SCENARIO.md
assets/queries/checkout_latency/query.txt
assets/queries/customer_spans/SCENARIO.md
assets/queries/customer_spans/query.txt
assets/queries/prod_outliers/SCENARIO.md
assets/queries/prod_outliers/query.txt
assets/queries/slow_db/SCENARIO.md
assets/queries/slow_db/query.txt
references/api-limits.md
references/concepts-span.md
references/concepts-trace.md
references/console-deep-links.md
references/conventions-gcp-legacy.md

Showing 24 of 89 files. Browse the folder on GitHub.

Suede Skill Check: 89/100 · B

Report snapshot · October 19, 2026 · graded-v2

The rubric totals 100 points; published scores are capped at 99. Security scan: not scanned.

Source revision: e86adb9e2b80. Report version 9acd9fff66d3. Badge URLs follow the latest listing; save the report to keep this version.

Download report · Request a fresh review

What to review next

Example request: 0 of 3 points. 3 when the description quotes an example request (3–60 characters in quotation marks).
Tool permissions declared: 0 of 2 points. 2 when the frontmatter declares allowed-tools.
Compatibility declared: 0 of 2 points. 2 when the frontmatter declares compatibility.

Add declarations and bundled files when they describe the skill’s actual needs. Update the source, then request a fresh review with the changed commit or PR.

cloud-trace-querying passes the required frontmatter check and all seven graded checks, which cover the SKILL.md format, a declared license and a commit in the last year. Those checks earn 56 of the score’s points; the rest come from description quality, instruction depth, bundled files, maintenance and curated-list citations. How the score works.

See the checks and points

Check	Result
Frontmatter parses and declares a name and a description	Pass
Name uses lowercase letters, digits and hyphens, 64 characters or fewer	Pass
Name matches the skill's folder name	Pass
Description is between 50 and 1,024 characters	Pass
Description says when an agent should use the skill	Pass
SKILL.md body is 500 lines or fewer	Pass
A license is declared in the frontmatter or the repository	Pass
Repository has a commit in the last 12 months	Pass

Score component	Points
Structural checks	56 of 56
Description length	5 of 5
Boundary clause	4 of 4
Example request	0 of 3
Instruction depth	7 of 7
Reference files	3 of 3
Bundled scripts	2 of 2
Recent maintenance	9 of 9
Curated-list citations	3 of 7
Tool permissions declared	0 of 2
Compatibility declared	0 of 2

Two badges for cloud-trace-querying

Choose the numeric badge, the letter badge, or both. Each links to this skill’s Suede listing; either valid linked badge can qualify for the feature offer.

Markdown

[![Suede Skill Check: 89/100](https://skills.suedeai.ai/directory/google/skills/cloud-trace-querying/score.svg)](https://skills.suedeai.ai/directory/google/skills/cloud-trace-querying/)
[![Suede Skill Check: Grade B](https://skills.suedeai.ai/directory/google/skills/cloud-trace-querying/badge.svg)](https://skills.suedeai.ai/directory/google/skills/cloud-trace-querying/)

HTML

<a href="https://skills.suedeai.ai/directory/google/skills/cloud-trace-querying/"><img src="https://skills.suedeai.ai/directory/google/skills/cloud-trace-querying/score.svg" alt="Suede Skill Check: 89/100" width="160" height="175"></a>
<a href="https://skills.suedeai.ai/directory/google/skills/cloud-trace-querying/"><img src="https://skills.suedeai.ai/directory/google/skills/cloud-trace-querying/badge.svg" alt="Suede Skill Check: Grade B" width="160" height="175"></a>

Suede Certified on the shield refers to this published structural quality check. Security scan: not scanned. Read the methodology.

Limited-time feature offer: display either the numeric or letter badge in your repository or skill README (both also qualify), then request badge verification. Eligible skills scoring 80–99 can receive a featured placement after Suede verifies at least one valid badge linked to the skill’s listing. Suede has not announced an end date.