Sns Topic Config - Auto-activating skill for AWS Skills. Triggers on: sns topic config, sns topic config Part of the AWS Skills skill category.
33
Quality
3%
Does it follow best practices?
Impact
81%
0.97xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./planned-skills/generated/13-aws-skills/sns-topic-config/SKILL.mdQuality
Discovery
7%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This description is severely lacking in all key areas. It provides no concrete actions, no natural trigger terms users would actually say, and no guidance on when to use the skill. It reads more like a category label than a functional skill description.
Suggestions
Add specific actions the skill performs, e.g., 'Creates, configures, and manages AWS SNS topics. Sets up subscriptions, access policies, and delivery settings.'
Include a 'Use when...' clause with natural trigger terms: 'Use when the user needs to set up notifications, configure pub/sub messaging, create SNS topics, or manage AWS notification services.'
Add common variations of terminology users might use: 'SNS', 'Simple Notification Service', 'push notifications', 'message topics', 'AWS messaging'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description contains no concrete actions whatsoever. 'Sns Topic Config' is repeated but never explains what actions can be performed (create, configure, subscribe, publish, etc.). | 1 / 3 |
Completeness | The description fails to answer 'what does this do' beyond naming the topic, and provides no 'when should Claude use it' guidance. There is no 'Use when...' clause or equivalent. | 1 / 3 |
Trigger Term Quality | The trigger terms are just 'sns topic config' repeated twice, which is technical jargon. Missing natural terms users would say like 'notification', 'pub/sub', 'message queue', 'AWS notifications', or 'SNS'. | 1 / 3 |
Distinctiveness Conflict Risk | While 'SNS Topic Config' is somewhat specific to AWS SNS, the lack of detail means it could overlap with other AWS skills. The mention of 'AWS Skills skill category' provides some context but doesn't clearly distinguish from other AWS-related skills. | 2 / 3 |
Total | 5 / 12 Passed |
Implementation
0%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill content is an empty template that provides zero actionable information about SNS topic configuration. It consists entirely of placeholder text describing what a skill should do rather than actually teaching Claude how to configure SNS topics. The content fails on all dimensions as it contains no code, no commands, no workflows, and no real guidance.
Suggestions
Add concrete AWS CLI commands or CloudFormation/Terraform examples for creating and configuring SNS topics (e.g., `aws sns create-topic --name MyTopic`)
Include specific configuration options like access policies, encryption settings, delivery policies, and subscription filters with executable examples
Define a clear workflow for SNS topic setup: create topic -> configure access policy -> add subscriptions -> verify with test message
Add references to related documentation for advanced patterns like cross-account access, FIFO topics, or message filtering
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is entirely boilerplate with no actual SNS topic configuration information. It explains what the skill does in abstract terms without providing any concrete guidance, wasting tokens on meta-description rather than actionable content. | 1 / 3 |
Actionability | No concrete code, commands, or specific instructions are provided. The content only describes what the skill claims to do ('provides step-by-step guidance') without actually providing any guidance, examples, or executable configurations. | 1 / 3 |
Workflow Clarity | No workflow is defined. There are no steps for configuring SNS topics, no validation checkpoints, and no sequence of operations. The phrase 'step-by-step guidance' is mentioned but never delivered. | 1 / 3 |
Progressive Disclosure | The content is a flat template with no meaningful structure. There are no references to detailed documentation, no links to examples or advanced configurations, and no organization of content by complexity or use case. | 1 / 3 |
Total | 4 / 12 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 — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
0c08951
Table of Contents
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.