sns

AWS SNS notification service for pub/sub messaging. Use when creating topics, managing subscriptions, configuring message filtering, sending notifications, or setting up mobile push.

0.97x

Quality

82%

Does it follow best practices?

Impact

94%

0.97x

Average score across 3 eval scenarios

Securityby

Passed

No findings from the security scan

Quality

Content

72%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 thorough, highly actionable SNS reference rich in executable examples, but it functions as a monolithic wall of reference content with no validation checkpoints in its batch workflows and no progressive disclosure into bundle files.

Suggestions

Add explicit validation checkpoints to the fan-out and publish workflows (e.g. verify subscription status is Confirmed before publishing, confirm queue policy permits SNS before relying on delivery) to lift workflow clarity above the batch-operation cap.

Move the CLI Reference tables and the full filter-policy catalog into separate reference files (e.g. references/cli-reference.md, references/filter-policies.md) and link to them one level deep so the SKILL.md body stays a lean overview.

Trim the introductory A2A/A2P definition and de-duplicate commands already demonstrated in the Common Patterns section to tighten token efficiency.

Dimension	Reasoning	Score
Conciseness	Mostly efficient with executable snippets and minimal concept re-explanation, though the intro defines A2A/A2P and the CLI Reference tables duplicate commands already shown in the patterns section.	4 / 5
Actionability	Copy-paste ready AWS CLI and boto3 examples plus concrete filter-policy JSON cover the common cases (create/subscribe, publish, fan-out, filtering) fully.	5 / 5
Workflow Clarity	Patterns are sequenced (e.g. fan-out: create topic, create queues, subscribe, publish) but lack validation checkpoints; per the rubric, batch/one-to-many operations without verification cap this at 3.	3 / 5
Progressive Disclosure	Well-structured with a TOC and clear sections, but the ~400-line body inlines bulky reference material (CLI tables, full filter-policy catalog) that belongs in separate bundle files; no one-level-deep references exist.	3 / 5
	Total	15 / 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 well-crafted description that names the service, lists five concrete capabilities, and provides an explicit 'Use when' trigger clause in third person. Only minor keyword-synonym gaps keep it from a perfect score.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'creating topics, managing subscriptions, configuring message filtering, sending notifications, or setting up mobile push' — covering the service comprehensively.	5 / 5
Completeness	Explicitly answers both 'what' ('AWS SNS notification service for pub/sub messaging') and 'when' ('Use when creating topics...') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Good natural keyword coverage ('topics', 'subscriptions', 'message filtering', 'notifications', 'mobile push', 'pub/sub messaging') but misses common synonyms like SMS/text messages and fan-out.	4 / 5
Distinctiveness Conflict Risk	Scoped to AWS SNS with service-specific triggers (SNS topics, subscriptions, mobile push); clear niche with minimal overlap risk against sibling AWS skills.	5 / 5
	Total	19 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: itsmostafa/aws-agent-skills
Path: skills/sns/SKILL.md
Commit: e786d25

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.