CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aws-sdk-java-v2-s3

Provides Amazon S3 patterns and examples using AWS SDK for Java 2.x. Use when working with S3 buckets, uploading/downloading objects, multipart uploads, presigned URLs, S3 Transfer Manager, object operations, or S3-specific configurations.

60

Quality

76%

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

The body is a well-organized, highly actionable S3 reference with concrete executable examples and a proper references bundle, but it is undermined by padded/duplicated sections, inlined Spring Boot content that belongs in the existing reference file, and a workflow that lacks explicit validation checkpoints — notably for the destructive batch delete operation, which caps workflow clarity at 3.

Suggestions

Add an explicit validation checkpoint before destructive batch operations — e.g., list and confirm the object keys before calling DeleteObjects, and verify partial failures in the response require retry/rollback — which currently caps workflow_clarity at 3.

Merge the duplicate 'Constraints and Limitations' and 'Constraints and Warnings' sections into a single section, and drop the 'Amazon S3 is object storage...' overview sentence explaining concepts Claude already knows.

Move the full Spring Boot integration code into the existing references/s3-spring-boot-integration.md and keep a brief pointer plus one minimal config example inline, trimming getter/setter stubs and repeated '// Use the latest stable version' comments.

DimensionReasoningScore

Conciseness

The body is mostly efficient, code-forward content, but includes unnecessary padding: an Overview sentence explaining what Amazon S3 is ('object storage built to store and retrieve any amount of data from anywhere'), a duplicated pair of constraint sections ('Constraints and Limitations' and 'Constraints and Warnings' both covering the 5GB PUT limit and eventual consistency), repeated '// Use the latest stable version' comments, and a '// ... other getters and setters' stub. This fits 'mostly efficient but could be tightened' better than the 'several padded sections' of 2.

3 / 5

Actionability

Concrete, near copy-paste-ready Java examples cover the common cases (createBucket with waiter, putObject/getObject, presigned URLs, Transfer Manager, batch delete, Spring Boot config), matching the 4 anchor. It falls short of 5 because several snippets are not fully self-contained: listObjects uses Flux without declaring the Reactor dependency, Spring Boot service snippets reference RequestBody/S3Presigner without imports, and the Examples section calls methods (bucketExists, uploadWithMetadata) defined elsewhere.

4 / 5

Workflow Clarity

The 8-step Instructions sequence is present and code examples include some implicit checkpoints (waitUntilBucketExists, per-object error handling in deleteObjects), but there are no explicit validation checkpoints in the workflow itself, and the destructive batch DeleteObjects operation has no pre-verification step — the rubric's batch-operation rule caps this dimension at 3. The 4 anchor's 'most checkpoints present' is not met, while steps are clearly listed so 2 is too low.

3 / 5

Progressive Disclosure

All three referenced bundle files exist, contain substantial material, and are clearly signaled with one-level-deep links in the References section ('[AWS S3 Object Operations Reference](./references/s3-object-operations.md)', etc.), and the body serves as an overview with well-labeled sections. It misses 5 because ~170 lines of Spring Boot integration and full worked examples are inlined despite a dedicated s3-spring-boot-integration.md reference existing, and the References section sits at the bottom rather than being signposted contextually per topic.

4 / 5

Total

14

/

20

Passed

Description

83%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 with a clear third-person 'what' statement and an explicit 'Use when...' clause enumerating concrete S3 triggers. Coverage of natural trigger terms is good, with only minor gaps in comprehensiveness (bucket policies, CORS, Spring Boot) and small overlap risk with the companion core SDK skill.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'S3 buckets, uploading/downloading objects, multipart uploads, presigned URLs, S3 Transfer Manager, object operations, or S3-specific configurations' — but 'S3-specific configurations' is somewhat generic and bucket policies, CORS, lifecycle rules, and Spring Boot integration covered by the skill are omitted, so it sits between the 4 and 5 anchors rather than clearly matching comprehensive coverage.

4 / 5

Completeness

It explicitly answers both: 'Provides Amazon S3 patterns and examples using AWS SDK for Java 2.x' (what) and 'Use when working with S3 buckets, uploading/downloading objects, multipart uploads, presigned URLs...' (when), matching the anchor-5 example structure with concrete trigger phrases. The when-clause is explicit and enumerates concrete triggers, so nothing below 5 fits better.

5 / 5

Trigger Term Quality

Good natural keyword coverage ('S3 buckets', 'uploading/downloading objects', 'multipart uploads', 'presigned URLs', 'S3 Transfer Manager') that users would actually say, though a few common variations like 'AWS S3', 'copy objects', or 'bucket policy' are missing. It is noticeably above the midpoint but not the comprehensive synonym-level coverage of the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The AWS SDK for Java 2.x + S3 combination carves a clear niche, but the skill body lists a closely related companion skill ('aws-sdk-java-v2-core'), creating minor overlap risk for generic AWS SDK for Java 2.x questions that could trigger either skill. Mostly distinct with minor overlap risk fits the 4 anchor; there is no clear conflict with unrelated skills that would justify 3.

4 / 5

Total

17

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (718 lines); consider splitting into references/ and linking

Warning

allowed_tools_field

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

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/developer-kit

Path

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