CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

setting-up-cloudwatch-alarm-notifications

Sets up notification channels for CloudWatch alarms using SNS topics and subscriptions. Always use this skill when configuring alarm notifications — it creates encrypted SNS topics, configures topic policies for CloudWatch access, sets up email/SMS/webhook subscriptions, and links alarms to notification actions with proper security controls.

Quality

89%

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

The canonical home for this skill is setting-up-cloudwatch-alarm-notifications in aws/agent-toolkit-for-aws

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.

Well-structured progressive disclosure: a lean overview that defers the multi-step procedure to a single real reference file with strong validation checkpoints, plus concrete inline troubleshooting commands. The main improvements are trimming the Overview paragraph that duplicates the frontmatter description, and noting the troubleshooting section is also duplicated verbatim in the reference file.

Suggestions

Trim the Overview paragraph, which restates the frontmatter description almost verbatim, down to a single line of purpose.

Deduplicate the Troubleshooting section: either keep the quick inline version in SKILL.md and remove it from the reference, or reduce the inline copy to one-line pointers so the content lives in one place.

DimensionReasoningScore

Conciseness

The body is lean overall and the troubleshooting section gives tight, command-level guidance, but the Overview paragraph ("Covers creating encrypted SNS topics, setting up subscriptions for email, SMS, and webhook endpoints...") nearly restates the frontmatter description and could be trimmed to one line. "follow the procedure exactly" is mild filler. This matches the anchor for efficient content with minor instances that could be trimmed — not the anchor below, since there is no concept re-teaching or substantial padding.

4 / 5

Actionability

The troubleshooting section is directly executable ("Use `aws sns list-subscriptions-by-topic` to check that the subscription status is 'Confirmed'", "Ensure the phone number is in E.164 format (e.g., +12345678901)"), but the core setup procedure in the body is a pointer ("follow the procedure exactly. See [references/...]") rather than any inline commands. Mostly executable guidance with a minor gap — the reference file does contain copy-paste-ready AWS CLI commands, which keeps it above the pseudocode/incomplete anchor.

4 / 5

Workflow Clarity

The body unambiguously delegates to a real procedure file whose 9-step sequence has explicit validation checkpoints: verify dependencies and alarm existence before proceeding (steps 1–2, with an error-recovery branch when the alarm is missing), verify encryption via topic attributes (step 4), verify the alarm update by re-describing it (step 7), and test the full loop by setting state to ALARM and resetting to OK (step 8). This matches the anchor with explicit validation steps and feedback loops for error recovery; no destructive/batch cap applies since verification is present.

5 / 5

Progressive Disclosure

The SKILL.md is a short overview with one clearly signaled, one-level-deep reference — "See [CloudWatch alarm notification setup procedure](references/setup-cloudwatch-alarm-notifications.md)" — and the referenced file exists and contains no nested references. The split is appropriate: detailed SOP in the reference, overview and quick troubleshooting inline for immediate answers without loading the full procedure.

5 / 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 enumerates concrete capabilities, includes an explicit "Always use this skill when..." trigger clause, uses third-person voice, and carves out a distinct niche. The only gap is modest synonym coverage in trigger terms (e.g., "alerts", "notify").

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "creates encrypted SNS topics", "configures topic policies for CloudWatch access", "sets up email/SMS/webhook subscriptions", "links alarms to notification actions" — comprehensively covering the domain. It matches the anchor for multiple specific concrete actions with comprehensive coverage; the trailing "with proper security controls" is the only soft phrase but it is anchored by the concrete encryption/policy actions.

5 / 5

Completeness

It explicitly answers both questions: the "what" is enumerated concretely (create encrypted topics, configure policies, set up subscriptions, link alarms) and the "when" is an explicit trigger clause — "Always use this skill when configuring alarm notifications". Not below the top anchor because the when-guidance is fully explicit rather than implied or vague.

5 / 5

Trigger Term Quality

Natural terms like "CloudWatch alarms", "alarm notifications", "notification channels", "SNS topics", and "email/SMS/webhook" cover the main vocabulary a user would say. A few common synonyms are missing (e.g., "alerts", "notify me when", "alarm actions"), so it sits at good-but-not-comprehensive keyword coverage rather than the comprehensive synonym coverage of the top anchor.

4 / 5

Distinctiveness Conflict Risk

The niche is precise — SNS-backed notification channels for CloudWatch alarms — with distinctive triggers (CloudWatch, SNS, alarm notifications) that are unlikely to fire for unrelated skills. Third-person voice ("Sets up notification channels") is used correctly, so no voice penalty applies.

5 / 5

Total

19

/

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/setting-up-cloudwatch-alarm-notifications/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.