CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

java-architect

Use when building, configuring, or debugging enterprise Java applications with Spring Boot 3.x, microservices, or reactive programming. Invoke to implement WebFlux endpoints, optimize JPA queries and database performance, configure Spring Security with OAuth2/JWT, or resolve authentication issues and async processing challenges in cloud-native Spring applications.

73

Quality

92%

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 well-structured skill body: a numbered workflow with real validation commands and error-recovery feedback loops, executable code examples, clear MUST DO/MUST NOT constraints, and a properly implemented progressive-disclosure table whose referenced files all exist and carry their weight. The only trimmable fat is the redundant technology-name list and footer metadata.

DimensionReasoningScore

Conciseness

The body is dense and actionable with no concept explanations Claude already knows — workflow steps, constraints, executable code, and a reference table all earn their tokens. Not 5 because of minor trimmable content: the "Knowledge Reference" section is a redundant dump of ~20 technology names already covered contextually, and the intro tagline plus maintainer footer add tokens without guidance value.

4 / 5

Actionability

Fully executable guidance: three complete, copy-paste-ready Java examples (WebFlux controller, JPA repository with JOIN FETCH and projection, SecurityFilterChain bean), concrete commands with specifics ("./mvnw verify -pl <module>", "./gradlew check", JaCoCo report path "target/site/jacoco/index.html"), and an explicit output checklist. Specific examples cover the common cases for this skill.

5 / 5

Workflow Clarity

The 6-step Core Workflow has explicit validation steps and feedback loops: "run ./mvnw verify -pl <module> to confirm query correctness. If integration tests fail: review Hibernate SQL logs, fix queries or mappings, re-run before proceeding", plus error-recovery guidance for security wiring and coverage shortfalls. Matches the validate → fix → re-run anchor pattern exactly.

5 / 5

Progressive Disclosure

Clear overview with a well-signaled Topic/Reference/"Load When" table pointing to five one-level-deep reference files, all verified to exist with substantial, non-duplicative content (inline code examples do not repeat reference content). Content is appropriately split: overview and quick-start examples in SKILL.md, depth in references.

5 / 5

Total

19

/

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 that explicitly states both what the skill does and when to use it, with concrete, third-person action verbs and dense natural trigger terms tied to the Spring/Java ecosystem. The only weaknesses are minor: a couple of missing common synonyms (Hibernate, REST) and one broad phrase ("database performance") that slightly raises conflict risk with adjacent skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions — "implement WebFlux endpoints", "optimize JPA queries and database performance", "configure Spring Security with OAuth2/JWT", "resolve authentication issues and async processing challenges" — with comprehensive coverage of the skill's declared domains (setup, reactive, data, security, async). Not 4 because there are no meaningful gaps in capability coverage.

5 / 5

Completeness

Explicitly answers both questions: "Use when building, configuring, or debugging enterprise Java applications with Spring Boot 3.x, microservices, or reactive programming" states when, and "Invoke to implement WebFlux endpoints, optimize JPA queries..." states what, with concrete trigger phrases throughout. Matches the anchor-5 good example structure exactly.

5 / 5

Trigger Term Quality

Strong natural keyword coverage: "Spring Boot 3.x", "microservices", "WebFlux", "JPA", "Spring Security", "OAuth2/JWT", "reactive programming", "enterprise Java" — all phrases users would naturally say. Not 5 because a few common natural terms are missing, e.g. "Hibernate", "Spring", and "REST API" as standalone trigger variations.

4 / 5

Distinctiveness Conflict Risk

Clear niche (enterprise Java/Spring) with mostly distinct triggers (WebFlux, JPA, Spring Security, OAuth2/JWT), but "optimize JPA queries and database performance" includes the broad phrase "database performance", which creates minor overlap risk with a closely related database-optimization skill. Not 5 because that phrase could fire for non-Java database tuning requests.

4 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

Jeffallan/claude-skills

Path

skills/java-architect/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.