Observability Triage
every-app/open-seo
Triage OpenSEO production errors in Cloudflare Workers Observability — verified query recipes, counting gotchas, and a known-noise filter list applied automatically.
Diagnose and operate Spring AI projects with version-aware Maven or Gradle checks for ChatClient, advisors, retrieval, conversation memory, tool/MCP boundaries, streaming, configuration, and…
Install Spring AI
$ npx skills add magnus919/agent-skills --skill spring-ai -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install magnus919/agent-skills spring-ai --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/spring-ai .claude/skills/spring-ai && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "spring-ai" agent skill from https://github.com/magnus919/agent-skills/tree/main/spring-ai into .claude/skills/spring-ai/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "spring-ai", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/magnus919/agent-skills/tree/main/spring-aiType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add magnus919/agent-skills --skill spring-ai -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install magnus919/agent-skills spring-ai --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/spring-ai .agents/skills/spring-ai && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "spring-ai" agent skill from https://github.com/magnus919/agent-skills/tree/main/spring-ai into .agents/skills/spring-ai/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "spring-ai", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add magnus919/agent-skills --skill spring-ai -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install magnus919/agent-skills spring-ai --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/spring-ai .cursor/skills/spring-ai && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "spring-ai" agent skill from https://github.com/magnus919/agent-skills/tree/main/spring-ai into .cursor/skills/spring-ai/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "spring-ai", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/magnus919/agent-skills.git --path spring-ai--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add magnus919/agent-skills --skill spring-ai -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install magnus919/agent-skills spring-ai --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/spring-ai .gemini/skills/spring-ai && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "spring-ai" agent skill from https://github.com/magnus919/agent-skills/tree/main/spring-ai into .gemini/skills/spring-ai/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "spring-ai", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install magnus919/agent-skills spring-aiInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add magnus919/agent-skills --skill spring-ai -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/spring-ai .github/skills/spring-ai && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "spring-ai" agent skill from https://github.com/magnus919/agent-skills/tree/main/spring-ai into .github/skills/spring-ai/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "spring-ai", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add magnus919/agent-skills --skill spring-ai -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install magnus919/agent-skills spring-ai --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/spring-ai .opencode/skills/spring-ai && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "spring-ai" agent skill from https://github.com/magnus919/agent-skills/tree/main/spring-ai into .opencode/skills/spring-ai/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "spring-ai", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
spring-ai- GitHub stars
- 115
- Token cost
- ~1.2k tokens
- SKILL.md length
- 517 words
- Files
- 11 (incl. scripts, references)
- Skills in repo
- 131
- Repo updated
- First seen
- Licence
- MIT
At a glance
Diagnose and operate Spring AI projects with version-aware Maven or Gradle checks for ChatClient, advisors, retrieval, conversation memory, tool/MCP boundaries, streaming, configuration, and…
- Works in 8 steps: Run the checker and retain its JSON… → Resolve build compatibility findings… → Inspect ChatClient advisor order and… → …
- Setup compatibility
- SKILL.md covers Entry check, Workflow, Scope and routing and Version posture, plus 1 more section
- Runs Python and Java scripts from its folder; calls python3
What it does
Spring AI is an agent skill from magnus919/agent-skills. Diagnose and operate Spring AI projects with version-aware Maven or Gradle checks for ChatClient, advisors, retrieval, conversation memory, tool/MCP boundaries, streaming, configuration, and observability. Use for setup compatibility, local smoke checks, and failure triage; do not use for provider-specific model evaluation, general Java/Spring development, security threat modeling, or production rollout governance.
Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 20 other files, including scripts and reference files (for example `README.md`, `evals/evals.json` and `references/compatibility-and-setup.md`). Compatibility notes: Requires Python 3.8+ standard library; Maven/Gradle are optional and only needed to run a project build.
It sits in DevOps & Cloud, covering Machine learning, Threat modeling and Observability. It works with Model Context Protocol, Gradle and Java. The repository describes itself as: Curated collection of AI agent skills for Hermes and other agent frameworks. The licence is MIT.
When your agent uses it
- Setup compatibility
- Local smoke checks
- Do not use for provider-specific model evaluation
- General Java/Spring development
Example prompts
- “/spring-ai”
Requirements
- Python 3
- Compatibility (from SKILL.md): Requires Python 3.8+ standard library; Maven/Gradle are optional and only needed to run a project build.
Workflow steps
8 steps, taken from the first numbered list in SKILL.md.
- Run the checker and retain its JSON output with the project revision.
- Resolve build compatibility findings against the official Spring AI and Spring Boot documentation in references/source-index.md; do not…
- Inspect ChatClient advisor order and parameters. Every memory-advisor call needs an explicit conversation identifier derived from the…
- For retrieval, verify document ownership/authorization before retrieval context enters a prompt. Test empty retrieval, stale data…
- For tools and MCP, treat model tool requests as untrusted proposals. The application owns authorization and execution. Bound tool names…
- For streaming, preserve partial output as provisional until completion; test cancellation, timeout, disconnect, and failed completion. Do…
- Keep prompt/completion logging disabled by default in production. If enabled temporarily, document redaction, access, retention, and…
- Run the project’s own tests/build when dependencies and provider credentials are available. The checker does not prove provider…
What it can do on your machine
Read from SKILL.md and the folder at commit 22b4723. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 2 files in scripts/ (Python and Java), which the agent can run.
Shell commands in SKILL.md call:
python3
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Compatibility
Requires Python 3.8+ standard library; Maven/Gradle are optional and only needed to run a project build.
From compatibility in the SKILL.md frontmatter.
Context cost
Spring AI loads about 1.2k tokens when it runs, and up to ~2.7k if it reads all its reference files. Until then it costs about 107 tokens; SKILL.md has 517 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
The full file from magnus919/agent-skills at commit 22b4723, republished under its MIT licence (© magnus919). 517 words, ~1,213 tokens.
Download SKILL.mdSave it as
.claude/skills/spring-ai/SKILL.md (or your agent's skills folder). This skill also uses 10 other files; get the full folder from GitHub.- name
- spring-ai
- description
- Diagnose and operate Spring AI projects with version-aware Maven or Gradle checks for ChatClient, advisors, retrieval, conversation memory, tool/MCP boundaries, streaming, configuration, and observability. Use for setup compatibility, local smoke checks, and failure triage; do not use for provider-specific model evaluation, general Java/Spring development, security threat modeling, or production rollout governance.
- compatibility
- Requires Python 3.8+ standard library; Maven/Gradle are optional and only needed to run a project build.
- license
- MIT
- metadata.tags
- spring-ai, spring-boot, java, maven, gradle, chatclient, rag, mcp, diagnostics
- metadata.verified_date
- 2026-09-14
- metadata.supported_spring_ai
- 2.0.1 (current stable documentation); 1.0.9 maintenance reference
Spring AI
Use this operational skill to inspect a real Maven or Gradle Spring AI project before changing it. The included diagnostic CLI is offline and provider-neutral: it reads build files, application configuration, and source to report compatibility clues, unsafe defaults, missing conversation IDs, streaming prerequisites, tool/MCP boundaries, retrieval configuration, and observability risks. It never sends prompts or exposes API-key values.
Entry check
Confirm the project root and whether the task is read-only or will modify configuration/code. Read-only diagnosis can proceed. Before the first state-changing action, confirm the target project, scope, and rollback path (usually a reviewed commit or revert); the CLI itself is read-only.
Run:
python3 spring-ai/scripts/spring_ai_check.py --root /path/to/project --jsonThe result is stable JSON with status, project, facts, findings, and errors. Exit 0 means no error-severity finding; exit 1 means an error-severity finding or warnings promoted by --strict; exit 2 means an invalid invocation or unreadable project.
Workflow
- Run the checker and retain its JSON output with the project revision.
- Resolve build compatibility findings against the official Spring AI and Spring Boot documentation in
references/source-index.md; do not infer support from a transitive dependency alone. - Inspect ChatClient advisor order and parameters. Every memory-advisor call needs an explicit conversation identifier derived from the application’s authenticated/session boundary; never use a shared default.
- For retrieval, verify document ownership/authorization before retrieval context enters a prompt. Test empty retrieval, stale data, provider errors, and latency separately.
- For tools and MCP, treat model tool requests as untrusted proposals. The application owns authorization and execution. Bound tool names, arguments, timeout, retry, side effects, and audit fields. Verify MCP transport and schema against the current project dependency.
- For streaming, preserve partial output as provisional until completion; test cancellation, timeout, disconnect, and failed completion. Do not treat a partial stream as a committed answer or side effect.
- Keep prompt/completion logging disabled by default in production. If enabled temporarily, document redaction, access, retention, and rollback.
- Run the project’s own tests/build when dependencies and provider credentials are available. The checker does not prove provider connectivity, model quality, RAG correctness, or production readiness.
Show full SKILL.md (172 more words)Show less
Scope and routing
- ChatClient/advisors, Spring configuration, local diagnostics, and framework troubleshooting belong here.
- Model quality, evaluator design, statistical comparisons, and trace schemas belong to
agent-evals-and-observability. - Authority, fallback, disablement, budgets, and rollout belong to
agent-production-operations. - Threat modeling and security implementation belong to
secure-software-engineering. - General Java/Spring application design belongs to the relevant engineering skill.
Version posture
The official documentation currently presents Spring AI 2.0.1 as the latest stable line and retains a 1.0 reference (1.0.9). APIs differ across lines: for example, current 2.0 documentation describes ToolCallingAdvisor as the ChatClient tool loop, while 1.x applications may use model-internal tool loops. The checker reports observed versions and flags uncertainty; it does not rewrite dependencies or claim that a version combination is supported without a primary compatibility source. Re-check references/source-index.md and release notes when upgrading.
Completion
Stop when the project’s build/config/source facts, findings, owner routes, and limitations are recorded, or when an external dependency (provider credentials, unavailable build tool, private artifact repository) is explicitly marked blocked. Do not claim a successful live smoke test from static diagnostics.
© magnus919, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 10 other files (scripts, references) in spring-ai of magnus919/agent-skills.
- SKILL.md
- README.md
- evals/evals.json
- examples/minimal-project/pom.xml
- examples/minimal-project/src/main/java/example/Demo.java
- examples/minimal-project/src/main/resources/application.properties
- references/compatibility-and-setup.md
- references/integration-boundaries.md
- references/source-index.md
- scripts/spring_ai_check.py
- scripts/test_spring_ai_check.py
Open the folder on GitHubat commit 22b4723
Compare with similar skills
Spring AI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Spring AI this skillmagnus919/agent-skills | 115 | — | ~1.2k | Automated safety check: Pass | MIT | |
| Observability Triageevery-app/open-seo | 23k | — | ~1.7k | Automated safety check: Pass | MIT | |
| UModel Root Cause Analysisalibaba/UnifiedModel | 415 | — | ~1.9k | Automated safety check: Pass | Custom licence | |
| Agentmeasureroy-tong/AgentMeasure | 219 | — | ~753 | Automated safety check: Pass | MIT | |
| Logging Observabilitygetsentry/toolkit | 920 | — | ~2.6k | Automated safety check: Pass | Custom licence | |
| Deploy Observabilityaliyun/alibabacloud-observability-mcp-server | 166 | — | ~2.6k | Automated safety check: Notes | None |
Similar skills
UModel Root Cause Analysis
alibaba/UnifiedModel
Investigates a service incident to its root cause by querying a UModel object graph alongside metrics, logs, topology and recent deployments.
Agentmeasure
roy-tong/AgentMeasure
Check whether agent telemetry preserves measurement semantics.
- Official
Logging Observability
getsentry/toolkit
Review code for correct logging and error handling patterns.
Deploy Observability
aliyun/alibabacloud-observability-mcp-server
Deploy, start, and update the Alibaba Cloud Observability MCP Server (阿里云可观测 MCP Server).
- Official
Exploring Apm Traces
PostHog/posthog
Investigates distributed application performance using PostHog APM (OpenTelemetry span) data via MCP.
More from magnus919/agent-skills
All 131 skills in this repoArtifact Pyramids
magnus919/agent-skills
Organize durable agent research outputs as summaries, analysis, and evidence dossiers.
Ascii City Engine
magnus919/agent-skills
Build portable, first-person colored ASCII city engines and small GIS-derived city packs.
Color Management
magnus919/agent-skills
Manage color workflows with ICC profiles, working spaces, gamut mapping, and color science.
Data Scientist
magnus919/agent-skills
A skill your agent uses for PhD-level expertise in data science, statistics, and machine learning: rigorous statistical analysis, experimental design, causal inference, advanced modeling, research…
Docker Compose
magnus919/agent-skills
Use Docker Compose to define, run, debug, and harden multi-container applications.
Fpga Development
magnus919/agent-skills
Design, review, simulate, and verify FPGA logic using explicit RTL contracts, clock and reset models, CDC analysis, timing constraints, and reproducible implementation evidence.
Related
Works with
Categories
Questions about Spring AI
What does Spring AI do?
Diagnose and operate Spring AI projects with version-aware Maven or Gradle checks for ChatClient, advisors, retrieval, conversation memory, tool/MCP boundaries, streaming, configuration, and…. Spring AI is an agent skill from magnus919/agent-skills. Diagnose and operate Spring AI projects with version-aware Maven or Gradle checks for ChatClient, advisors, retrieval, conversation memory, tool/MCP boundaries, streaming, configuration, and observability.
When should I use Spring AI?
Spring AI fits situations like: setup compatibility; local smoke checks; do not use for provider-specific model evaluation; general Java/Spring development.
How do I install Spring AI in Claude Code?
Run `npx skills add magnus919/agent-skills --skill spring-ai -a claude-code`. Or copy the skill folder (spring-ai in magnus919/agent-skills) into .claude/skills/spring-ai in your project. Claude Code loads it when a task matches its description.
How do I install Spring AI in Codex?
Run `npx skills add magnus919/agent-skills --skill spring-ai -a codex`. Or copy the skill folder (spring-ai in magnus919/agent-skills) into .agents/skills/spring-ai in your project. Codex loads it when a task matches its description.
Can I use Spring AI in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add magnus919/agent-skills --skill spring-ai -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/spring-ai, .gemini/skills/spring-ai, .github/skills/spring-ai and .opencode/skills/spring-ai in your project.
What does Spring AI need to run?
Going by SKILL.md and its folder, Spring AI needs Python and Java for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3. Compatibility (from SKILL.md): Requires Python 3.8+ standard library; Maven/Gradle are optional and only needed to run a project build..
Does Spring AI access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Spring AI safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Spring AI use?
Spring AI is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Spring AI use?
About 1.2k tokens (SKILL.md is roughly 4.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.5k tokens, read only when the agent opens those files.
What are the alternatives to Spring AI?
Skills that share tags, products or a category with Spring AI: Observability Triage (every-app/open-seo, 23k stars), UModel Root Cause Analysis (alibaba/UnifiedModel, 415 stars), Agentmeasure (roy-tong/AgentMeasure, 219 stars) and Logging Observability (getsentry/toolkit, 920 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Spring AI?
magnus919 (a GitHub user) maintains it in magnus919/agent-skills, which has 115 GitHub stars. The repository holds 131 skills in this directory. The repository was last updated on October 10, 2026.
Source: magnus919/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.