CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

rca

Root-cause analysis of one AQuA insight against the observed agent's own source code. Use when a message names an insight and asks what the root cause is, how to fix it, why the agent behaved that way, or to diagnose a failure -- for example `Diagnose insight <id> ("<label>") — what is the root cause, and how would you fix it?`. Reads the source snapshot at the revision the failure ran on, plus the complete conversations behind the insight, and answers with `<path>:<start>-<end>` citations, and records the proposed fix against the insight.

Quality

92%

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

88%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.

A well-crafted instruction-only skill body: a numbered procedure with exact tool calls, an explicit answer contract, validation and error-recovery loops, and no filler or general-knowledge padding. Its weaknesses are minor — some redundant revision discussion and a monolithic single-file structure that could offload tool-reference detail to a separate file.

DimensionReasoningScore

Conciseness

The body is dense and domain-specific — it explains only AQuA tool semantics Claude could not know (scope fields, edit anchoring, snapshot revisioning) and never pads with general knowledge. It is not a 5 because revision-consistency is covered twice (step 3 and the 'Code and conversations must be the same revision' section) and several passages ('Omitting the sentence reads as confidence you do not have') could be trimmed without loss.

4 / 5

Actionability

For an instruction-only skill the guidance is fully executable: exact tool calls with parameters ('Call `get_insight` with the insight id and `include_traces=False`', 'Pass `revision=<agent_revision>` to every one of these calls', 'Paginate with `next_page_token`'), an exact edit schema ('a `path`, a 1-based inclusive `start_line`..`end_line`, the replacement text in `after`, and a one-line `rationale`'), and a fixed citation format. Edge cases (empty revision, absent code, refused records) are all handled specifically.

5 / 5

Workflow Clarity

Steps 0–4 are given in order with explicit checkpoints and feedback loops: 'read the `record` it returns to confirm the anchor is the code you meant', and on refusal 'The tool refuses the whole record if any one edit cannot be anchored... Correct that range and resend'. Incomplete evidence and unverified fixes each have a mandated disclosure step. This matches the anchor for clear sequence with explicit validation and error-recovery loops.

5 / 5

Progressive Disclosure

The single file is well-sectioned with clear headers, no nested or buried references, and no bundle files to navigate (references/, scripts/, assets/ are absent). It is not a 5: at ~165 lines it exceeds the simple-skill threshold, and material such as tool parameter semantics and the absent-code taxonomy is inlined where it could arguably live in a one-level-deep reference file.

4 / 5

Total

18

/

20

Passed

Description

92%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: it names the domain and each concrete action of the workflow, gives an explicit 'Use when' clause with natural trigger phrasing and a verbatim example message, and is sharply scoped to a niche. Third-person voice is used consistently throughout. The only gap is a few missing natural synonyms (e.g., 'debug', 'investigate') in the trigger terms.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Reads the source snapshot at the revision the failure ran on, plus the complete conversations behind the insight', 'answers with `<path>:<start>-<end>` citations, and records the proposed fix' — with a concrete output format and comprehensive coverage of the workflow. It exceeds the 'several specific actions; minor gaps' anchor because every phase of the task (read code, read conversations, cite, record) is named explicitly.

5 / 5

Completeness

Both parts are explicit: the what ('Root-cause analysis of one AQuA insight against the observed agent's own source code... Reads the source snapshot... records the proposed fix') and the when ('Use when a message names an insight and asks what the root cause is...') with concrete trigger phrases and an example message. This matches the anchor for clearly and explicitly answering both what and when.

5 / 5

Trigger Term Quality

It includes natural trigger phrasing — 'what the root cause is, how to fix it, why the agent behaved that way, or to diagnose a failure' — plus a verbatim example message, giving good keyword coverage. It falls short of the 5 anchor because common synonyms a user might naturally say ('debug', 'investigate', 'troubleshoot') are absent.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — diagnosing 'one AQuA insight against the observed agent's own source code' — with a trigger tied to 'a message names an insight', so it is unlikely to fire for unrelated skills. It sits fully at the 'clear niche with distinct triggers; minimal conflict risk' anchor.

5 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

google/adk-samples

Path

core/python/ambient-quality-agent/src/ambient_quality_agent/skills/rca/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.