CtrlK
BlogDocsLog inGet started
Tessl Logo

jbaruch/spring-ai-agent

Build AI agents with Spring AI 2.0 - basic agent, memory, tools/MCP, agentic workflows, guardrails, and observability

86

2.43x
Quality

85%

Does it follow best practices?

Impact

90%

2.43x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

Quality

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 identifies the technology stack with version numbers, lists multiple concrete capabilities, and includes an explicit 'Use when' clause with natural trigger terms. It is concise, specific, and highly distinguishable from other skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: building AI agents, creating chat agents, adding memory, tool calling, MCP integration, advisor-based workflows, guardrails, and observability. These are all concrete, identifiable capabilities.

3 / 3

Completeness

Clearly answers both 'what' (build AI agents with Spring AI 2.0.x and Spring Boot 4.0.x) and 'when' (explicit 'Use when' clause listing specific trigger scenarios like creating chat agents, adding memory, tool calling, MCP integration, etc.).

3 / 3

Trigger Term Quality

Includes strong natural keywords users would say: 'Spring AI', 'Spring Boot', 'chat agents', 'memory', 'tool calling', 'MCP integration', 'guardrails', 'observability', plus version numbers (2.0.x, 4.0.x) that help with precise matching. These are terms developers naturally use.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive due to the specific framework (Spring AI 2.0.x, Spring Boot 4.0.x) and domain-specific terms like 'advisor-based workflows', 'MCP integration', and 'guardrails'. Unlikely to conflict with generic coding or other AI framework skills.

3 / 3

Total

12

/

12

Passed

Implementation

64%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a highly actionable and comprehensive Spring AI 2.0 skill with excellent executable code examples covering the full spectrum of agent development. Its main weaknesses are its monolithic length (which hurts both conciseness and progressive disclosure) and the lack of explicit validation/verification checkpoints in multi-step workflows like migration and project setup. The breaking changes section and version matrix are valuable additions for a milestone-stage framework.

Suggestions

Split detailed sections (MCP integration, agentic workflow patterns, observability config) into separate referenced files, keeping SKILL.md as a concise overview with links like '**MCP Integration**: See [MCP.md](MCP.md) for client/server setup'

Add explicit validation checkpoints to the migration workflow (Section 1) and project setup—e.g., 'After running OpenRewrite, verify compilation with `mvn compile` and check for remaining deprecated imports'

Trim the model provider table to only the most common 3-4 providers and reference a separate file for the full list

DimensionReasoningScore

Conciseness

The skill is comprehensive and mostly efficient for its scope, but includes some unnecessary verbosity—e.g., the full model provider table with empty 'Notes' columns, extensive MCP annotation examples that could be referenced externally, and some explanatory text that Claude would already know. However, given the breadth of Spring AI 2.0 coverage, most content earns its place.

2 / 3

Actionability

Excellent actionability throughout—nearly every section includes fully executable, copy-paste-ready code examples with proper imports, annotations, and configuration. The complete agent example in Section 9 with pom.xml, application.properties, and Java code is particularly strong. Maven/Gradle snippets, YAML configs, and Java code are all concrete and specific.

3 / 3

Workflow Clarity

While individual sections are well-structured and the complete agent example provides a clear end-to-end picture, the skill lacks explicit validation checkpoints. For example, the migration workflow (Section 1) doesn't include verification steps after running OpenRewrite. The agentic workflow patterns (Section 7) show patterns but don't include error handling or validation steps. For a skill involving dependency management and breaking changes, explicit 'verify this works before proceeding' steps would be valuable.

2 / 3

Progressive Disclosure

The content is well-organized with numbered sections and clear headers, but at ~600+ lines it's a monolithic document that could benefit from splitting detailed sections (MCP integration, agentic patterns, observability) into separate referenced files. The single external reference to the agentic-patterns GitHub repo is good, but more content should be offloaded to keep SKILL.md as an overview with pointers.

2 / 3

Total

9

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

Total

10

/

11

Passed

Reviewed

Table of Contents