Back to catalog
Human reviewedDevelopment

Skill dossier

java-architect

Source declaration

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.

The author's original description, preserved in English. It describes intent, not verified performance.

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.

developmentreferences

Research summary

Human reviewed

Skill Atlas editorial review · editorial-preview-1.0.0

A Java Skill for enterprise Spring Boot 3.x work with Java 21, covering domain design, JPA optimization, WebFlux, Spring Security and Maven or Gradle verification steps.

Review scope

Deterministic static analysis of collected SKILL.md and supporting text/code. Machine-assisted candidates and findings await human editorial review; no dynamic behavior or effect is assessed.

Observable capabilities

  • Reviews project structure and models the domain with DDD and Clean Architecture.
  • Optimizes JPA queries and runs ./mvnw verify to confirm correctness.
  • Configures Spring Security with OAuth2 and JWT and externalizes configuration.
  • Targets 85% or higher coverage using the JaCoCo report and adds missing tests.

Limitations & scope

  • Scoped to Java 21 and Spring Boot 3.x; older Spring versions are not covered.
  • Verification commands assume Maven or Gradle wrappers exist in the project.
  • Generated code and test results are not verified here.

Relevant for

  • Enterprise Java developers on Spring Boot
  • Teams moving to reactive WebFlux services

What ships with the skill

The file inventory comes from the collected source at the recorded commit. Paths and sizes are structural observations, not a measure of quality.

files
6
Markdown files
6
scripts
0
references
5
Size
62.5 KB
Structural complexity
Low

File inventory

PathTypeBytes
skills/java-architect/references/jpa-optimization.mdReference10.6 KB
skills/java-architect/references/reactive-webflux.mdReference9.2 KB
skills/java-architect/references/spring-boot-setup.mdReference7.6 KB
skills/java-architect/references/spring-security.mdReference14.8 KB
skills/java-architect/references/testing-patterns.mdReference14.5 KB
skills/java-architect/SKILL.mdInstruction5.7 KB

SKILL.md frontmatter

{
  "name": "java-architect",
  "description": "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.",
  "license": "MIT",
  "metadata": {
    "author": "https://github.com/Jeffallan",
    "company": "https://synergetic.solutions",
    "version": "1.1.0",
    "domain": "language",
    "triggers": "Spring Boot, Java, microservices, Spring Cloud, JPA, Hibernate, WebFlux, reactive, Java Enterprise",
    "role": "architect",
    "scope": "implementation",
    "output-format": "code",
    "related-skills": "fullstack-guardian, api-designer, devops-engineer, database-optimizer"
  }
}

A reading of the operating sequence

This workflow reconstructs the apparent sequence from source material. Unless controlled evaluation is explicitly recorded, it is provisional—not an observed trace.

  1. 01
    Input

    Analyze architecture

    Review project structure, dependencies and Spring configuration.

  2. 02
    Action

    Design the domain

    Create models following DDD and Clean Architecture, and resolve unclear boundaries before implementation.

  3. 03
    Decision

    Verify and fix

    Run ./mvnw verify after data and security changes and, if tests fail, review logs and configuration and re-run.

  4. 04
    Output

    Reach coverage and deliver

    Confirm all tests pass with 85% or higher coverage, then provide models, services, repositories, controllers and tests.

Potential risk surfaces

Static findings identify points to inspect before installation. They do not establish that a skill is safe, malicious, or effective.

Attention recommended

165 deterministic lexical finding(s) require review across the collected text. Findings can occur in documentation and do not prove execution or exploitability; binary-only files were not scanned.

Network accessObserved
File writesObserved
Credential useObserved
Medium

Network access is mentioned

20 occurrences

A URL or network client appears in this source line. Review destinations, data sent, and trust boundaries; static text cannot establish actual network activity. This rule matched 20 location(s) in the collected text; 3 representative location(s) are cited. Matching text may be documentation, and the analyzer did not execute it.

Note

File modification is described or implemented

142 occurrences

This line contains a possible file-write or redirection operation. Check destination paths and overwrite behavior; the static review did not write any file. This rule matched 142 location(s) in the collected text; 3 representative location(s) are cited. Matching text may be documentation, and the analyzer did not execute it.

High

Credential or secret material is referenced

3 occurrences

This line resembles a credential literal or reads a sensitive environment value. Do not expose its contents; verify whether it is a placeholder, required secret, or accidentally committed material. This rule matched 3 location(s) in the collected text; 3 representative location(s) are cited. Matching text may be documentation, and the analyzer did not execute it.

Editorial security note

Review the generated SecurityFilterChain, CSRF settings and JWT validation configuration before deploying.

Where context can be spent

Discovery, activation, and resource layers have different meanings. Exact values appear only when the official token-counting method was run with a named model.

Exact token counts unavailable

All token values, including per-file inventory, are null until the pipeline performs an official exact count with an explicit model.

No token measurement was recorded with the required official method. This dossier does not substitute character counts, file sizes, or estimates.

Controlled evaluation

No controlled evaluation

This skill has only the evidence identified above. No task success, token efficiency, latency, or quality advantage is claimed.

Not tested

Use with the source in view

Install command
git clone https://github.com/Jeffallan/claude-skills.git cd claude-skills # Copy this skill directory into one of: # ~/.claude/skills/java-architect # .claude/skills/java-architect
  1. Open the pinned source at https://github.com/Jeffallan/claude-skills/blob/67c1961b180dc92cf08983344627109e983e8f51/skills/java-architect/SKILL.md.
  2. Review the license, prerequisites and all bundled reference files.
  3. Copy the skill directory into a personal or project-level Claude Code skills directory.
  4. Restart or refresh Claude Code so the skill can be discovered.
Verify installation

Ask Claude Code to add a repository query and confirm it runs ./mvnw verify and reports JaCoCo coverage.

Prerequisites

  • Scoped to Java 21 and Spring Boot 3.x; older Spring versions are not covered.
  • Verification commands assume Maven or Gradle wrappers exist in the project.
  • Generated code and test results are not verified here.

Example prompts

Representative task

Use the java-architect skill to add a WebFlux OrderController with GET and POST endpoints, a JPA repository using JOIN FETCH to avoid N+1, and OAuth2 JWT resource server security, then run ./mvnw verify.

Inspect before use

Read the java-architect skill at https://github.com/Jeffallan/claude-skills/blob/67c1961b180dc92cf08983344627109e983e8f51/skills/java-architect/SKILL.md. Explain its workflow, required tools, permissions and the main risks before I decide whether to install it.

A decision, with its limits attached

Strengths

  • Ties implementation steps to verification commands with fix-and-rerun guidance.
  • Examples cover WebFlux, JOIN FETCH queries and a JWT security filter chain.

Considerations

  • The example security config disables CSRF, which must be justified for your application.
  • The 85% coverage target is a fixed figure that may not suit every project.
Research conclusion

A thorough Spring Boot guide with practical verification loops, best used with a security review of the generated configuration.

Traceable by construction

The dossier is a time-bound reading of a public artifact, not an endorsement. Use the source link to inspect the exact upstream material.

Jeffallanclaude-skillsskills/java-architect
Source type
Community
Commit
67c1961b180dc92cf08983344627109e983e8f51
Collected
20 Nov 2026
Last checked
20 Nov 2026
Upstream license
MIT
Repository stars
12,464
Content basis

Deterministic lexical parsing, YAML frontmatter validation, file inventory, source-described workflow extraction, and heuristic provisional classification of the supplied files only. Generated by machine; no LLM, execution, dynamic testing, or human editorial approval.