CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aws-observability

Builds, configures, debugs, and optimizes AWS observability using CloudWatch (Logs Insights, Metrics, Alarms, Dashboards, EMF), X-Ray, CloudTrail, and ADOT. Covers Log Insights query syntax (fields, filter, stats, parse, pattern, join, subqueries), alarm configuration (metric, composite, anomaly detection, missing data treatment), dashboard design, custom metrics (PutMetricData, EMF, metric filters), X-Ray tracing (ADOT, sampling rules, annotations vs metadata), ADOT collector config, and CloudTrail auditing. Use when the user mentions CloudWatch, Log Insights, alarms, INSUFFICIENT_DATA, dashboards, custom metrics, EMF, X-Ray, traces, sampling, CloudTrail, who deleted, ADOT, OpenTelemetry, observability, monitoring, synthetics, canaries, or troubleshooting alarm behavior. Do NOT use for application logging setup, container log drivers, or security threat detection.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

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.

A well-designed router-style SKILL.md: concise, verifiable references one level deep, and an unambiguous routing table covering every bundle file. The two weaknesses are the redundant duplication between the Routing and Files tables and the absence of any inline quick-start example for trivial requests.

Suggestions

Merge the Routing and Files tables into a single table (User need | File | Contents) to remove the duplicated file listing and save roughly 10 lines.

Add one inline quick-start example — e.g., a minimal Log Insights query or a single aws cloudwatch CLI command — so simple requests can be handled without loading a reference file.

Tighten the reference-freshness note to one clause attached to the Files table (e.g., 'verify version/quota values against AWS docs when precision matters') instead of a standalone paragraph.

DimensionReasoningScore

Conciseness

The body is lean — no explanation of concepts Claude already knows, a two-sentence overview, and a genuinely useful freshness caveat ('confirm values against current AWS documentation'). It falls short of anchor 5 only because the Files table duplicates the Routing table's coverage of the same 10 files; merging them would trim roughly 10 lines.

4 / 5

Actionability

Directives are concrete and executable ('Read troubleshooting.md — starts with the 5 most common fixes', 'Use alarm-template.ts as a starting point'), and per the instruction-only carve-out absent code is not penalized. It sits at anchor 4 rather than 5 because there is no inline quick-start example — even a trivial request (e.g., a basic Log Insights query or one CLI command) forces loading a reference file first.

4 / 5

Workflow Clarity

The skill's single action — routing a user need to the right reference — is made unambiguous by an exhaustive Routing table with a fallback row ('Spans multiple areas → Read the most specific reference first, then consult others as needed'). No validation checkpoints are applicable since the body involves no destructive or batch operations, so the simple-skill exception applies: the single action is unambiguous.

5 / 5

Progressive Disclosure

Scored against the actual bundle: all 10 referenced files (8 references + 2 assets) exist, and inspection confirms references are exactly one level deep — reference files contain only internal anchors and external AWS doc links, no nested file references. The body is a clear overview with two well-signaled navigation tables (task-to-file routing plus content summaries), matching the anchor-5 structure.

5 / 5

Total

18

/

20

Passed

Description

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

An excellent description: dense with concrete capabilities, comprehensive natural trigger terms including synonyms and user-voiced phrases, explicit what/when structure, and a negative boundary that sharply limits conflict risk. It stays specific without padding.

DimensionReasoningScore

Specificity

Concrete third-person verbs ('Builds, configures, debugs, and optimizes') are backed by an exhaustive enumeration of specific capabilities ('fields, filter, stats, parse, pattern, join, subqueries', 'PutMetricData, EMF, metric filters', 'annotations vs metadata'). Coverage is comprehensive across the domain, matching the anchor-5 example's density; anchor 4 would require minor gaps that are not present.

5 / 5

Completeness

Explicitly answers 'what' (two sentences of concrete capabilities) and 'when' ('Use when the user mentions...'), plus a negative boundary ('Do NOT use for application logging setup, container log drivers, or security threat detection'). This mirrors the anchor-5 exemplar structure; anchor 4 would require a less explicit or specific 'when' clause.

5 / 5

Trigger Term Quality

'Use when the user mentions CloudWatch, Log Insights, alarms, INSUFFICIENT_DATA, dashboards, custom metrics, EMF, X-Ray, traces, sampling, CloudTrail, who deleted, ADOT, OpenTelemetry, observability, monitoring, synthetics, canaries' provides ~19 natural trigger terms including synonyms (traces/sampling/OpenTelemetry, synthetics/canaries) and real user phrases like 'who deleted' and the alarm state 'INSUFFICIENT_DATA'. No common variation appears missing, satisfying the comprehensive-synonyms anchor.

5 / 5

Distinctiveness Conflict Risk

A clear niche (AWS observability) with highly distinct service-specific triggers and an explicit exclusion clause that prevents misfires on adjacent topics like application logging or threat detection. Overlap risk from broad words like 'monitoring' is mitigated by the AWS anchoring and the Do-NOT-USE boundary, fitting the minimal-conflict anchor rather than anchor 4's 'minor overlap risk'.

5 / 5

Total

20

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository

mreferre/aws-agent-toolkit-skills

Path

.kiro/skills/aws-observability/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.