CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aws-sdk-java-v2-messaging

Provides AWS messaging patterns using AWS SDK for Java 2.x for SQS queues and SNS topics. Handles sending/receiving messages, FIFO queues, DLQ, subscriptions, and pub/sub patterns. Use when implementing messaging with SQS or SNS.

58

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./plugins/developer-kit-java/skills/aws-sdk-java-v2-messaging/SKILL.md

The canonical home for this skill is giuseppe-trisciuoglio/developer-kit

SKILL.md
Quality
Evals
Security

Quality

Content

61%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 solid, code-centric skill with executable examples covering the common SQS/SNS cases and a genuinely useful, well-linked reference bundle. Its weaknesses are repetition across sections (client setup and best-practice items each appear multiple times) and workflows that list steps without validation checkpoints, which the rubric caps for batch/destructive message processing.

Suggestions

Keep the client-builder setup in one place only — it currently appears in 'Basic Client Setup', in both 'Examples' blocks, and again in 'Instructions > Configure Clients'.

Add explicit validation checkpoints to the message-processing workflow, e.g. 'Delete only after processing succeeds; on failure, let the visibility timeout expire or route the message to the DLQ' — this also lifts the workflow_clarity cap that applies to batch/destructive operations.

Replace the full inline Spring Boot example with a short pointer to references/spring-boot-integration.md (keeping at most a minimal snippet) to shorten SKILL.md and avoid duplicating the reference file's scope.

DimensionReasoningScore

Conciseness

The SqsClient/SnsClient builder setup is repeated three times ("Basic Client Setup", the "Basic SQS Operations" / "Basic SNS Operations" examples, and "Instructions > Configure Clients"), and long polling, batching, and visibility-timeout guidance appears in both "Best Practices" and "Performance Optimization". The bulk is useful code rather than padded prose, so this is not a 2, but the duplication is more than the 'minor instances' of anchor 4.

3 / 5

Actionability

Snippets are concrete and near-copy-paste ready: Maven dependencies, client builders, create/send/receive/delete flows, FIFO attribute maps, and the SNS-to-SQS subscription with queue-ARN retrieval. Minor gaps keep it below anchor 5: the Spring Boot example relies on undefined `Order`/`ObjectMapper` beans, and snippets like the FIFO example omit `Map`/`UUID` imports.

4 / 5

Workflow Clarity

"Implement Message Processing" (Connect → Create → Send/receive → Process → Delete → Handle failures) and the 5-step Spring Boot sequence give a clear order, so above anchor 2. But there are no validation checkpoints or feedback loops (no verify-before-delete, no fix-and-retry), and the rubric explicitly caps workflows involving batch/destructive operations without validation at 3 — message deletion and batch processing are exactly that.

3 / 5

Progressive Disclosure

A dedicated "Detailed References" section clearly signals four real, one-level-deep reference files with one-line descriptions, and the body is well-sectioned. Not anchor 5 because the full inline Spring Boot example duplicates the scope of references/spring-boot-integration.md and the ~320-line body carries advanced content that belongs in those references; not anchor 3 because references are clearly signaled, not buried.

4 / 5

Total

14

/

20

Passed

Description

75%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 clear, third-person description with a solid what/when structure and strong domain-specific trigger terms. It lands just below the top anchors on every dimension: coverage gaps in the capability list, missing synonym variants, a trigger clause that could name more use cases and does not bind the trigger to Java.

DimensionReasoningScore

Specificity

"Handles sending/receiving messages, FIFO queues, DLQ, subscriptions, and pub/sub patterns" names several specific capabilities in a clearly scoped domain ("AWS SDK for Java 2.x for SQS queues and SNS topics"). Falls short of anchor 5's comprehensiveness: queue/topic creation, Spring Boot integration, and testing — all covered by the skill — are absent, and 'Handles... FIFO queues, DLQ' names objects more than actions. Well above anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

Both parts are explicit: the 'what' ("Provides AWS messaging patterns... Handles sending/receiving messages, FIFO queues, DLQ, subscriptions, and pub/sub patterns") and the 'when' ("Use when implementing messaging with SQS or SNS"). The trigger clause is concrete but narrow — it wouldn't fire on related phrasings like setting up a queue, publishing to a topic, or configuring a DLQ — so it matches anchor 4 ('when' could be more explicit or specific) rather than anchor 5.

4 / 5

Trigger Term Quality

Good natural keyword coverage: "SQS", "SNS", "queues", "topics", "FIFO", "DLQ", "subscriptions", "pub/sub", "messaging" — terms users would actually say. Not anchor 5, which expects comprehensive synonyms and variations: missing "notifications", "event-driven", "message queue", or full service names (Simple Queue Service / Simple Notification Service).

4 / 5

Distinctiveness Conflict Risk

The opening sentence carves a clear niche ("AWS SDK for Java 2.x for SQS queues and SNS topics"), but the trigger clause "Use when implementing messaging with SQS or SNS" does not scope to Java, so a Python/Boto3 or generic AWS messaging request could match this skill. That is 'minor overlap risk with closely related skills' (anchor 4) rather than anchor 5's minimal conflict risk.

4 / 5

Total

16

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/developer-kit

Path

plugins/developer-kit-java/skills/aws-sdk-java-v2-messaging/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.