CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aws-sdk-java-v2-bedrock

Provides Amazon Bedrock patterns using AWS SDK for Java 2.x. Use when working with foundation models (listing, invoking), text generation, image generation, embeddings, streaming responses, or integrating generative AI with Spring Boot applications.

61

Quality

77%

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-bedrock/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

57%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-sectioned, highly actionable Bedrock cookbook whose code examples are close to executable, undermined by duplication and misplaced content: an Examples section that repeats Core Patterns, an inline model-ID catalog that belongs in an existing reference file, a broken examples/ link, and a workflow with no validation checkpoints. Tightening these would move it from adequate to strong.

Suggestions

Delete the Examples section or replace it with genuinely distinct examples — Example 1 (Claude invoke), Example 2 (streaming), and Example 3 (Spring service) each duplicate code already shown in Core Patterns and Spring Boot Integration.

Move the ~57-line Common Model IDs constant block into references/model-reference.md or references/models-lookup.md (both already exist and cover the same IDs), keeping only 3-4 current default IDs inline.

Add validation checkpoints to the Instructions workflow (e.g., verify credentials/model access after steps 1-2, confirm a test invocation succeeds before integrating) and fix the broken '[examples directory](examples/)' link, which points to a directory that does not exist in the bundle.

DimensionReasoningScore

Conciseness

The code blocks are lean, but the body carries several padded sections: the Examples section (lines 341-430) duplicates Core Patterns nearly verbatim (Claude invocation, streamResponse, and a Spring service each appear twice), a ~57-line inline model-ID constant block duplicates two existing reference files and embeds dated version strings, and Best Practices bullets overlap Constraints and Warnings. This is more padding than the level-3 'some unnecessary explanation', but since the majority of the file is dense executable code rather than prose explanation, it sits just above the midpoint rather than at level 2.

3 / 5

Actionability

Concrete, near-copy-paste Java for dependencies, client setup, per-provider payload construction, streaming handlers, embeddings, and Spring configuration. It falls short of level 5 because helper methods called in the code (extractTextFromResponse, processChunk, extractText) are never defined, and the Spring snippets omit imports and ObjectMapper wiring — minor gaps that break full executability.

4 / 5

Workflow Clarity

The Instructions section gives a coherent, correctly ordered 8-step sequence (credentials → enable model access → dependencies → clients → list → invoke → stream → integrate), but steps are one-line labels without commands, and there are no validation checkpoints (e.g., verifying model access or credentials before invoking) or feedback loops. This matches 'sequence present but checkpoints missing or implicit'; it is not a destructive/batch skill so the level-3 cap is not triggered, but the total absence of checkpoints keeps it below level 4.

3 / 5

Progressive Disclosure

References are clearly signaled ('See the [Model Reference](references/model-reference.md) for: ...') and 11 of 13 bundle files are linked, but the ~57-line Common Model IDs section is inline content that duplicates references/model-reference.md and references/models-lookup.md, the '[examples directory](examples/)' link points to a non-existent directory, and two bundle files (models-lookup.md, advanced-model-patterns.md) are never referenced and thus undiscoverable. This fits 'content that should be separate is inline' better than 'most content is appropriately placed'.

3 / 5

Total

13

/

20

Passed

Description

88%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: it states concrete capabilities in third person and pairs them with an explicit, enumerated 'Use when' trigger clause. Keyword coverage is good but misses a few natural synonyms (model family names like Claude/Llama/Titan, RAG, chatbot) that users would plausibly say.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "foundation models (listing, invoking)", "text generation, image generation, embeddings, streaming responses", "integrating generative AI with Spring Boot applications" — in third person, covering the skill's scope comprehensively. It exceeds the level-4 anchor because there are no meaningful coverage gaps relative to what the skill does.

5 / 5

Completeness

It explicitly answers both questions: "Provides Amazon Bedrock patterns using AWS SDK for Java 2.x" (what) and "Use when working with foundation models (listing, invoking), text generation, image generation, embeddings, streaming responses, or integrating generative AI with Spring Boot applications" (when, with concrete enumerated triggers). This matches the level-5 anchor; the 'when' clause is explicit, not merely present as at level 4.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "Amazon Bedrock", "AWS SDK for Java 2.x", "text generation", "embeddings", "streaming responses", "generative AI", "Spring Boot". A few natural terms users would say are missing (e.g., "Claude", "Llama", "Titan", "RAG", "chatbot"), so it does not reach the comprehensive-synonym coverage of level 5, but it is clearly above the level-3 anchor's 'missing common variations'.

4 / 5

Distinctiveness Conflict Risk

The Bedrock-on-Java-SDK niche is clear and mostly distinct from generic AWS or Spring skills, but "integrating generative AI with Spring Boot applications" and the existence of closely related skills (aws-sdk-java-v2-core, Spring skills) create minor overlap risk. It fits 'mostly distinct; minor overlap risk' rather than the minimal-conflict level-5 anchor.

4 / 5

Total

18

/

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

allowed_tools_field

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

Warning

relative_links

Relative link issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/developer-kit

Path

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