CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

amazon-ses

Amazon SES integration. Manage data, records, and automate workflows. Use when the user wants to interact with Amazon SES data.

Quality

65%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/amazon-ses/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body delivers a strong, executable CLI workflow with genuine error-state handling and feedback loops, and it stays self-contained without phantom references. Its main weaknesses are an introductory paragraph explaining a service Claude already knows, a dangling "Step 2" reference with inconsistent step numbering, and the absence of a concrete end-to-end SES action example.

Suggestions

Delete or compress the opening paragraph explaining what Amazon SES is and who uses it — Claude already knows this — and trim filler like "This is the fastest way to get a connection".

Fix the workflow numbering: replace the two "skip to **Step 2**" references with actual labeled steps (e.g. "## Step 1: Connect", "## Step 2: Discover and run actions") and remove the orphaned "1b" heading.

Add one concrete end-to-end example of discovering and running a real SES action (e.g. `membrane action list --intent "send email"` then `membrane action run <id> --input '{...}'`) so the common case is fully covered, and cut the vague "Use action names and parameters as needed" line.

DimensionReasoningScore

Conciseness

The body opens by explaining what Amazon SES is ("cloud-based email sending service... used by businesses of all sizes"), a concept Claude already knows, and includes padded sentences like "so you can focus on the integration logic rather than auth plumbing" and "This is the fastest way to get a connection". The bulk of the document is concrete commands, matching "mostly efficient but includes some unnecessary explanation" — above anchor 2 because padding is confined to a few sentences, below anchor 4 because the intro and filler phrases remain.

3 / 5

Actionability

Nearly all guidance is executable copy-paste CLI commands with concrete flags (`npm install -g @membranehq/cli@latest`, `membrane connection ensure "https://aws.amazon.com/ses/" --json`, the proxy flag table). It falls short of anchor 5 because no real SES action example is shown (e.g. actually sending an email) and "Use action names and parameters as needed" is vague filler.

4 / 5

Workflow Clarity

The install → login → connect → discover → run sequence is clear, with a well-specified connection state machine (READY, BUILDING, CLIENT_ACTION_REQUIRED, CONFIGURATION_ERROR) and re-poll feedback loops. It misses anchor 5 because "skip to **Step 2**" is referenced twice but no Step 2 heading exists — the workflow steps are inconsistently numbered (a "1b" appears with no "Step 1"/"Step 2" labels) and action execution has no output-validation guidance.

4 / 5

Progressive Disclosure

The skill is a self-contained single file with no bundle files or external references, organized into clear sections (Install, Authentication, Connecting, Searching, Running, Proxy, Best practices). It matches anchor 4's "good structure, most content appropriately placed" — slightly below anchor 5 because at ~140 lines the connection-state and proxy-option details could be split into reference files, and one cross-reference ("Step 2") is broken.

4 / 5

Total

15

/

20

Passed

Description

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

The description names the target service and includes an explicit "Use when" trigger, but the capability statement is generic template filler that would fit almost any integration skill. No concrete SES actions or email-domain vocabulary appear, leaving both specificity and trigger coverage weak.

Suggestions

Replace "Manage data, records, and automate workflows" with concrete SES actions, e.g. "Send transactional and marketing email, verify sender identities (domains and email addresses), manage configuration sets and templates".

Add natural trigger terms users would actually say: "Use when the user wants to send email via Amazon SES, set up email sending for an app, or mentions SES, transactional email, or sender verification".

Cut the vague "data, records" phrasing entirely — it adds no information and increases overlap risk with other data-integration skills.

DimensionReasoningScore

Specificity

The description names the domain ("Amazon SES integration") but the actions — "Manage data, records, and automate workflows" — are generic template phrases applicable to any integration, with no concrete SES capabilities like sending email, verifying identities, or managing templates. It is above anchor 1 because a domain is named, but below anchor 3 because no concrete SES-specific action is stated.

2 / 5

Completeness

An explicit "Use when the user wants to interact with Amazon SES data" clause answers "when" (avoiding the missing-trigger cap of 3), but the "what" — "Manage data, records, and automate workflows" — is vague boilerplate that does not convey what the skill concretely does. It sits between anchor 3 (clear what, weak when) and anchor 4 (both present, when could be more explicit), and the fluff-padded "what" keeps it at 3 rather than 4.

3 / 5

Trigger Term Quality

"Amazon SES" is the primary natural term a user would say, but common variations and synonyms — "send email", "transactional email", "email service" — are absent, matching the "some relevant keywords but missing common variations" anchor. It is above anchor 2 because the service name is a genuine natural keyword, and below anchor 4 because the email-related vocabulary users actually use is entirely missing.

3 / 5

Distinctiveness Conflict Risk

"Amazon SES" is a distinct niche AWS service and the trigger explicitly names it, keeping conflict risk low. It falls just below anchor 5 because the generic "Manage data, records, and automate workflows" tail is shared boilerplate across similar integration skills, creating minor overlap risk with closely related email/AWS skills.

4 / 5

Total

12

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

membranedev/application-skills

Path

skills/amazon-ses/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.