Agent skill

Solon Development Skill

by opensolon in opensolon/soloncode

Solon Java framework expert (NOT Spring). An agent skill from opensolon/soloncode.

MITAuto-check passedBackend & APIs

Install Solon Development Skill

skills CLI
$ npx skills add opensolon/soloncode --skill solon-development-skill -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install opensolon/soloncode solon-development-skill --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/opensolon/soloncode.git skills-src && mkdir -p .claude/skills && cp -r skills-src/soloncode-cli/release/skills/solon-development-skill .claude/skills/solon-development-skill && rm -rf skills-src

Use ~/.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/

Facts

Skill name
solon-development-skill
GitHub stars
197
Token cost
~1.8k tokens
SKILL.md length
517 words
Files
31 (incl. references, assets)
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Solon Java framework expert (NOT Spring). An agent skill from opensolon/soloncode.

  • Works in 10 steps: 框架守卫(优先于一切):本 skill 的规则只适用于「Solon… → Solon 不是 Spring。 禁止混用 Spring… → 禁止 Spring 依赖。 不要引入… → …
  • Projects the user is keeping on Spring/Spring Boot — if the workspace is a Spring project (spring-boot-starter-
  • SKILL.md covers Critical Rules, 执行流程, Scene Navigation(含阅读优先级) and 版本与变更, plus 1 more section
  • Runs Java scripts from its folder

What it does

Solon Development Skill is an agent skill from opensolon/soloncode. Solon Java framework expert (NOT Spring). Use ONLY for projects already using or being newly built with the Solon framework. DO NOT USE for projects the user is keeping on Spring/Spring Boot — if the workspace is a Spring project (spring-boot-starter-, @SpringBootApplication, application.yml) and the user has not explicitly requested Solon or a migration, keep it on Spring and do not load this skill. Use for Solon apps, Solon AI (ChatModel/RAG/MCP/Agent/Harness/Talent), Solon Flow, Solon Cloud, Nami RPC…

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 33 other files, including reference files and assets (for example `assets/minimal-web/README.md`, `assets/minimal-web/app.yml` and `references/ai_agent.md`).

It sits in Backend & APIs, covering Backend development and Retrieval-augmented generation. It works with Java, Spring Boot and Model Context Protocol. The repository describes itself as: The open source coding agent. The licence is MIT.

When your agent uses it

  • Projects the user is keeping on Spring/Spring Boot — if the workspace is a Spring project (spring-boot-starter-
  • @SpringBootApplication
  • Application.yml) and the user has not explicitly requested Solon
  • Keep it on Spring and do not load this skill

Example prompts

  • “/solon-development-skill”

Workflow steps

10 steps, taken from the first numbered list in SKILL.md.

  1. 框架守卫(优先于一切):本 skill 的规则只适用于「Solon 项目」或「用户明确要用 Solon 的新项目」。若当前项目实际是 Spring 项目且用户未明确要求迁移或改用 Solon:保持项目现有框架,禁止移除 Spring…
  2. Solon 不是 Spring。 禁止混用 Spring 注解(@Autowired、@SpringBootApplication、@RestController、@RequestMapping、@Service、@Repository、@Value、@ComponentSca…
  3. 禁止 Spring 依赖。 不要引入 spring-boot-starter-*、spring-*。Solon 坐标 groupId 为 org.noear。(仅在 Rule 0 判定为 Solon 项目后适用;Spring 项目里的 Spring 依赖不归本 skill 管)
  4. 配置文件是 app.yml(或 app.properties),不是 application.yml。
  5. 入口是 Solon.start(App.class, args),不是 SpringApplication.run()。
  6. 组件注解用 @Component,不要用 @Service / @Repository。
  7. 示例默认目标版本 4.1.0(除非用户指定其它版本)。
  8. Parent POM 为 solon-parent(groupId=org.noear)。
  9. 中文支持。 用户使用中文时,回复与代码注释使用中文。
  10. 不确定的 API 不要臆造。 优先查本 skill 的 reference;仍不确定时查官网/源码,禁止用 Spring 习惯补全。

What it can do on your machine

Read from SKILL.md and the folder at commit e8ee78a. 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 script files (Java, from the files we listed), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • solon.noear.org
    • github.com

    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.

Context cost

Solon Development Skill loads about 1.8k tokens when it runs, and up to ~47k if it reads all its reference files. Until then it costs about 181 tokens; SKILL.md has 517 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~181
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~47k

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from opensolon/soloncode at commit e8ee78a, republished under its MIT licence (© opensolon). 517 words, ~1,759 tokens.

Download SKILL.mdSave it as .claude/skills/solon-development-skill/SKILL.md (or your agent's skills folder). This skill also uses 30 other files; get the full folder from GitHub.
name
solon-development-skill
description
Solon Java framework expert (NOT Spring). Use ONLY for projects already using or being newly built with the Solon framework. DO NOT USE for projects the user is keeping on Spring/Spring Boot — if the workspace is a Spring project (spring-boot-starter-*, @SpringBootApplication, application.yml) and the user has not explicitly requested Solon or a migration, keep it on Spring and do not load this skill. Use for Solon apps, Solon AI (ChatModel/RAG/MCP/Agent/Harness/Talent), Solon Flow, Solon Cloud, Nami RPC, SqlUtils/MyBatis, and Solon annotations (@Mapping, @Inject, @SolonMain, @Component). Independent IoC/AOP and plugins — never use Spring annotations or spring-boot dependencies in Solon code.

Solon Development Skill

为使用 Solon 框架 构建 Java 应用提供专家级指导。Solon 是独立的全场景 Java 企业应用框架 — 与 Spring 不兼容,拥有自研架构、注解体系与生态。

官网: https://solon.noear.org
GitHub: https://github.com/opensolon/solon
License: Apache 2.0
JDK: Java 8 ~ 26,GraalVM Native Image
目标版本: 4.1.0(升级时全局替换此标记 + 复核 AI/Nami 变更段)

Critical Rules

  1. 框架守卫(优先于一切):本 skill 的规则只适用于「Solon 项目」或「用户明确要用 Solon 的新项目」。若当前项目实际是 Spring 项目且用户未明确要求迁移或改用 Solon:保持项目现有框架,禁止移除 Spring 依赖、改写启动类/注解/配置文件名,禁止把下面的「禁 Spring」规则反向套用到 Spring 项目上;意图不明时先询问用户。确属 Solon 项目时才适用下列规则。
  2. Solon 不是 Spring。 禁止混用 Spring 注解(@Autowired、@SpringBootApplication、@RestController、@RequestMapping、@Service、@Repository、@Value、@ComponentScan 等)。(仅在 Rule 0 判定为 Solon 项目后适用)
  3. 禁止 Spring 依赖。 不要引入 spring-boot-starter-*、spring-*。Solon 坐标 groupId 为 org.noear。(仅在 Rule 0 判定为 Solon 项目后适用;Spring 项目里的 Spring 依赖不归本 skill 管)
  4. 配置文件是 app.yml(或 app.properties),不是 application.yml。
  5. 入口是 Solon.start(App.class, args),不是 SpringApplication.run()。
  6. 组件注解用 @Component,不要用 @Service / @Repository。
  7. 示例默认目标版本 4.1.0(除非用户指定其它版本)。
  8. Parent POM 为 solon-parent(groupId=org.noear)。
  9. 中文支持。 用户使用中文时,回复与代码注释使用中文。
  10. 不确定的 API 不要臆造。 优先查本 skill 的 reference;仍不确定时查官网/源码,禁止用 Spring 习惯补全。

执行流程

  1. 判定框架归属(优先):确认当前项目是 Solon 项目(solon-parent、org.noear 依赖、app.yml、@SolonMain)或用户明确要用 Solon;否则按 Rule 0 处理(保持 Spring 现状 / 先问)。Spring 项目仅“顺带提到 Solon”不算。
  2. 判定场景 → 只 read 下表中对应的 1~2 个 reference(禁止一次加载全部)。
  3. 生成代码前核对 Critical Rules(尤其:app.yml、@Component、@Inject、无 Spring 依赖)。
  4. 数据访问优先读 references/data_access.md。
  5. AI 场景分流:
    • Chat/Tool/MCP/基础 RAG → references/ai_chat_rag_mcp.md
    • Loader/向量库/搜索插件表 → references/ai_rag_plugins.md
    • Agent/Talent/Loop → references/ai_agent.md
    • HarnessEngine/工具权限 → references/ai_harness.md
    • AI UI/ACP/A2A → references/ai_protocol_ui.md
  6. Cloud 分流:Config/Discovery/Event/Job → references/cloud_core.md;File/Breaker/Gateway/Trace/Metric/Id/Lock → references/cloud_ops.md。
  7. Remoting 分流:Nami RPC/HttpClient → references/remoting.md;过滤器/发现/LB → references/remoting_filter_lb.md;Socket.D → references/socketd.md。
  8. Flow 分流:YAML/Graph/节点 → references/flow_orchestration.md;中断恢复/Workflow/拦截器 → references/flow_workflow.md。
  9. Security 分流:Auth/CORS/Vault → references/security.md;参数校验 → references/validation.md。
  10. 从 Spring 迁移 → 使用 spring-to-solon-skill,本 skill 仅保留精简对照。
  11. 用户中文提问 → 中文回复与注释;默认版本 4.1.0。
  12. API 不确定时查 reference 或源码;禁止用 Spring 习惯或臆造坐标补全(例如不存在 solon-ai-rag / solon-ai-a2a)。

Scene Navigation(含阅读优先级)

根据场景只读 1~2 个文件。路径统一写完整相对路径(如 references/quick_start.md)。

基础与核心
优先级ScenarioReferenceGrep Keywords
必读项目初始化 / Maven / 构建 / 部署 / AOT / Nativereferences/quick_start.mdpom.xml, Solon.start, solon-maven-plugin, solon-aot
必读REST / MVC / Filter / 定时任务 / 模式速查references/common_patterns.md@Controller, Filter, @Mapping, @Scheduled
按需注解对照 / IoC / 配置 / SnEL / 与 Spring 差异references/core_concepts.md@Inject, @Configuration, app.yml, SnEL
进阶插件 SPI / E-SPI / H-SPI / 配置元数据references/plugin_spi.mdPlugin, solon-hotplug, SpiLoader, META-INF/solon
查阅依赖选择 / 模块列表 / 序列化 / 视图 / ORM 索引references/modules_reference.mdsolon-web, solon-lib, solon-rpc, solon-job
按需数据源 / SqlUtils / 事务 / MyBatis 用法references/data_access.mdSqlUtils, @Transaction, @Db, DataSource
查阅注解 / 配置属性 / WebSocket·EventBus·Filterreferences/api_reference.md@Mapping, @Bean, EventBus, WebSocket
Show full SKILL.md (215 more words)Show less
Web / 安全 / 通信
优先级ScenarioReferenceGrep Keywords
按需SSE / Reactivereferences/web_sse_reactive.mdSseEmitter, Flux, solon-web-sse, Mono
按需国际化 / Locale / 模板 i18nreferences/i18n.mdI18nUtil, I18nService, solon-i18n, LocaleResolver
按需认证 / 鉴权 / CORS / 配置加密 / 请求头安全references/security.mdAuthAdapter, @CrossOrigin, VaultUtils
按需参数校验 / 实体校验 / 校验器扩展references/validation.md@Valid, @NotNull, ValidatorManager
按需Nami RPC / 声明式 HttpClientreferences/remoting.md@NamiClient, @Remoting, solon-rpc, NamiAttach
按需Nami 过滤器 / 服务发现 / 负载均衡references/remoting_filter_lb.mdNamiManager, LoadBalance, CloudLoadStrategy
按需Socket.D 双向通信references/socketd.mdSocket.D, ClientSession, ServerEndpoint
运维 / 测试 / 云 / 流程
优先级ScenarioReferenceGrep Keywords
按需日志references/logging.mdsolon-logging, AppenderBase, logback
按需单元/集成/HTTP 测试 / Mockreferences/testing.md@SolonTest, HttpTester, @Rollback
按需配置中心 / 注册发现 / 事件 / 任务references/cloud_core.mdnacos, CloudClient, @CloudJob, @CloudEvent
按需文件 / 熔断 / 网关 / 链路 / 指标 / ID / 锁references/cloud_ops.mdCloudClient.file, @CloudBreaker, solon-cloud-gateway
按需Flow YAML / Graph / 节点类型references/flow_orchestration.mdFlowEngine, FlowContext, Graph, NodeType
按需Flow 中断恢复 / Workflow / 拦截器references/flow_workflow.mdtoJson, WorkflowExecutor, FlowInterceptor
AI
优先级ScenarioReferenceGrep Keywords
按需ChatModel / Tool / 基础 RAG / MCP / GenerateModelreferences/ai_chat_rag_mcp.mdChatModel, ToolMapping, MCP, EmbeddingModel
按需RAG Loader / 向量库 / 联网搜索插件references/ai_rag_plugins.mdsolon-ai-load, solon-ai-repo, PdfLoader
按需Agent / Talent / Loopreferences/ai_agent.mdReActAgent, Talent, solon-ai-loop
按需HarnessEngine / 工具权限 / 子代理 / 命令references/ai_harness.mdHarnessEngine, ToolPermission, AgentDefinition
按需AI UI / ACP / A2Areferences/ai_protocol_ui.mdAiSdkStreamWrapper, ACP, TeamProtocols.A2A

版本与变更

  • 默认稳定版:4.0.3;JDK 8 ~ 26
  • AI / Nami 等增量细节以对应 reference 为准(AI 见 references/ai_agent.md 末尾「4.0.3 AI 增量要点」;Nami 默认 snack4)
  • 升级版本时:全局替换 4.0.3 标记,并复核 AI、Nami、快捷依赖章节

最小模板

从零建 Web 项目可参考 assets/minimal-web/(pom.xml + App + HelloController + app.yml)。

© opensolon, 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 30 other files (references, assets) in soloncode-cli/release/skills/solon-development-skill of opensolon/soloncode.

  • SKILL.md
  • assets/minimal-web/App.java
  • assets/minimal-web/HelloController.java
  • assets/minimal-web/README.md
  • assets/minimal-web/app.yml
  • assets/minimal-web/pom.xml
  • references/ai_agent.md
  • references/ai_chat_rag_mcp.md
  • references/ai_harness.md
  • references/ai_protocol_ui.md
  • references/ai_rag_plugins.md
  • references/api_reference.md
  • references/cloud_core.md
  • references/cloud_ops.md
  • references/common_patterns.md
  • references/core_concepts.md
  • references/data_access.md
  • references/flow_orchestration.md
  • … and 13 more

Open the folder on GitHubat commit e8ee78a

Compare with similar skills

Solon Development Skill 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.

Solon Development Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Solon Development Skill this skillopensolon/soloncode197—~1.8kAutomated safety check: PassMIT
Intelliconnect Service Styleruanrongman/IntelliConnect147—~2.4kAutomated safety check: PassApache-2.0
Java Coding StandardsSnailclimb/AIGuide667—~1kAutomated safety check: PassNone
MCP Serverrrezartprebreza/spring-boot-skills2961 repos~1.1kAutomated safety check: PassMIT
MCP Serverrrezartprebreza/spring-boot-skills2961 repos~1.3kAutomated safety check: PassMIT
Reachai Onboardingw8123/EnterpriseAgentFramework830—~6.1kAutomated safety check: PassMIT

Similar skills

  • Intelliconnect Service Style

    ruanrongman/IntelliConnect

    Create or update IntelliConnect Spring Boot service/serviceimpl code in this repository style.

    147 GitHub stars~2.4k tokensUpdated 3 days ago
    Backend & APIsAuto-check passed
  • Java Coding Standards

    Snailclimb/AIGuide

    Java/Spring Boot 编码规范:用于编写、审查、重构和讲解 Java 代码。适用于 Java 风格、Spring Boot 架构、Controller/Service/Manager/DAO 分层、API 边界、Entity/VO/Form/DTO/BO 设计、MyBatis/MyBatis-Plus 持久化、事务、异常、日志、安全、性能、测试和 Java 代码评审等场景。默认结合…

    667 GitHub stars~1k tokensUpdated 3 mo ago
    Backend & APIsAuto-check passed
  • MCP Server

    rrezartprebreza/spring-boot-skills

    A skill your agent uses when exposing Spring Boot 3 application capabilities through Model Context Protocol tools, resources, or prompts.

    296 GitHub starsUsed in 1 repo~1.1k tokens
    Backend & APIsAuto-check passed
  • MCP Server

    rrezartprebreza/spring-boot-skills

    A skill your agent uses when exposing Spring Boot 4 application capabilities through Model Context Protocol tools, resources, or prompts.

    296 GitHub starsUsed in 1 repo~1.3k tokens
    Backend & APIsAuto-check passed
  • Reachai Onboarding

    w8123/EnterpriseAgentFramework

    Integrate Java business systems with ReachAI SDK registration, SDK instance heartbeat, gateway/embed access, and optional API Management handoff.

    830 GitHub stars~6.1k tokensUpdated 3 days ago
    AI & LLM EngineeringAuto-check passed
  • Java MCP Server Generator

    github/awesome-copilot

    Official

    Generate a complete Model Context Protocol server project in Java using the official MCP Java SDK with reactive streams and optional Spring Boot integration.

    40k GitHub starsUsed in 1 repo~5.5k tokens
    Agent WorkflowsAuto-check passed

More from opensolon/soloncode

  • Soloncode Skin Skill

    opensolon/soloncode

    Generate installable SolonCode Web UI skin zip packages from natural-language design requests.

    197 GitHub stars~1.9k tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about Solon Development Skill

What does Solon Development Skill do?

Solon Java framework expert (NOT Spring). An agent skill from opensolon/soloncode. Solon Development Skill is an agent skill from opensolon/soloncode. Solon Java framework expert (NOT Spring).

When should I use Solon Development Skill?

Solon Development Skill fits situations like: projects the user is keeping on Spring/Spring Boot — if the workspace is a Spring project (spring-boot-starter-; @SpringBootApplication; application.yml) and the user has not explicitly requested Solon; keep it on Spring and do not load this skill.

How do I install Solon Development Skill in Claude Code?

Run `npx skills add opensolon/soloncode --skill solon-development-skill -a claude-code`. Or copy the skill folder (soloncode-cli/release/skills/solon-development-skill in opensolon/soloncode) into .claude/skills/solon-development-skill in your project. Claude Code loads it when a task matches its description.

How do I install Solon Development Skill in Codex?

Run `npx skills add opensolon/soloncode --skill solon-development-skill -a codex`. Or copy the skill folder (soloncode-cli/release/skills/solon-development-skill in opensolon/soloncode) into .agents/skills/solon-development-skill in your project. Codex loads it when a task matches its description.

Can I use Solon Development Skill 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 opensolon/soloncode --skill solon-development-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/solon-development-skill, .gemini/skills/solon-development-skill, .github/skills/solon-development-skill and .opencode/skills/solon-development-skill in your project.

What does Solon Development Skill need to run?

Going by SKILL.md and its folder, Solon Development Skill needs Java for the scripts in its folder.

Does Solon Development Skill access the network?

SKILL.md names 2 domains. As links in the text: solon.noear.org and github.com. This is read from the text; nothing was executed.

Is Solon Development Skill 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. Review the folder before installing.

What licence does Solon Development Skill use?

Solon Development Skill is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Solon Development Skill use?

About 1.8k tokens (SKILL.md is roughly 7k 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 45k tokens, read only when the agent opens those files.

What are the alternatives to Solon Development Skill?

Skills that share tags, products or a category with Solon Development Skill: Intelliconnect Service Style (ruanrongman/IntelliConnect, 147 stars), Java Coding Standards (Snailclimb/AIGuide, 667 stars), MCP Server (rrezartprebreza/spring-boot-skills, 296 stars) and MCP Server (rrezartprebreza/spring-boot-skills, 296 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Solon Development Skill?

opensolon (a GitHub organization) maintains it in opensolon/soloncode, which has 197 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 5, 2026.

Source: opensolon/soloncode on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.