aws-sdk-java-v2-secrets-manager
AWS Secrets Manager patterns using AWS SDK for Java 2.x. Use when storing/retrieving secrets (passwords, API keys, tokens), rotating secrets automatically, managing database credentials, or integrating secret management into Spring Boot applications.
Install with Tessl CLI
npx tessl i github:giuseppe-trisciuoglio/developer-kit --skill aws-sdk-java-v2-secrets-manager84
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
Discovery
100%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 is an excellent skill description that clearly defines its scope (AWS Secrets Manager with Java SDK), lists concrete actions (storing, retrieving, rotating secrets), and provides explicit trigger guidance with natural keywords developers would use. The description is concise yet comprehensive, and the technology-specific focus makes it highly distinguishable from other skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'storing/retrieving secrets', 'rotating secrets automatically', 'managing database credentials', 'integrating secret management into Spring Boot applications'. Also specifies the technology stack (AWS SDK for Java 2.x). | 3 / 3 |
Completeness | Clearly answers both what ('AWS Secrets Manager patterns using AWS SDK for Java 2.x') and when ('Use when storing/retrieving secrets, rotating secrets automatically, managing database credentials, or integrating secret management into Spring Boot applications'). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'secrets', 'passwords', 'API keys', 'tokens', 'database credentials', 'rotating secrets', 'Spring Boot'. These are terms developers naturally use when discussing secret management. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with clear niche: specifically AWS Secrets Manager + Java 2.x SDK + Spring Boot. Unlikely to conflict with other skills due to the specific technology combination and explicit use cases. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid, actionable skill with excellent code examples and good progressive disclosure structure. The main weaknesses are some verbosity in explanatory sections that don't add value for Claude, and missing explicit workflow sequences for complex multi-step operations like secret rotation setup or migration scenarios.
Suggestions
Remove or significantly condense the 'When to Use' and 'Core Operations' sections - Claude can infer these from the code examples
Add an explicit workflow for secret rotation setup showing the sequence: create secret -> configure rotation Lambda -> test rotation -> verify
Remove the JSON structure examples section - these are standard patterns Claude already knows
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient but includes some unnecessary content like the 'When to Use' section that largely duplicates the description, and the 'Core Operations' section that just lists method names Claude already knows. The JSON structure examples and best practices sections add bulk without proportional value. | 2 / 3 |
Actionability | Provides fully executable, copy-paste ready code examples throughout - client setup, CRUD operations, caching, Spring Boot integration, and testing. Code is complete with proper imports and realistic patterns. | 3 / 3 |
Workflow Clarity | Individual operations are clear, but there's no explicit workflow for multi-step processes like secret rotation setup or initial secret management lifecycle. Error handling is shown but lacks a validate-fix-retry feedback loop for operations that could fail. | 2 / 3 |
Progressive Disclosure | Well-structured with clear sections progressing from Quick Start to advanced patterns. References to detailed guides (API Reference, Caching Guide, Spring Boot Integration) are clearly signaled at the end with one-level-deep links. | 3 / 3 |
Total | 10 / 12 Passed |
Validation
75%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 12 / 16 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
metadata_version | 'metadata' field is not a dictionary | Warning |
license_field | 'license' field is missing | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 12 / 16 Passed | |
- 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.