EasyYapi skill
EasyYapi exports APIs from Java and Kotlin code to YApi, Postman and OpenAPI, and its skill helps agents write export rules.
- 490 ★ on the repository
- Last commit
- AGPL-3.0
Extended access
Why this level
- The agent edits rule files in the project and export sends endpoint descriptions to external platforms.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/easyyapiDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The agent edits rule files in the project and export sends endpoint descriptions to external platforms.
This is third-party code. Review the repository files before installing.
What it does
EasyYapi is an IntelliJ IDEA plugin that reads Spring MVC, Feign, JAX-RS and gRPC controllers in Java and Kotlin projects and exports documentation to YApi, Postman, Markdown, cURL, OpenAPI 3.0.3, Hoppscotch and ApiPost. The API Explorer window searches and calls endpoints from inside the IDE. For agents there is the `easy-yapi-assistant` skill: it helps write rules in the `.easyapi/` folder (field renames, headers, ignored classes) from the same reference material as the built-in assistant. With the IDE's MCP server turned on (IntelliJ IDEA 2025.2 or newer), an agent can call `easyapi_scan_endpoints` and `easyapi_export`.
Who it is for. Java and Kotlin Spring developers who keep API docs in YApi or Postman and want an agent to set up export rules.
Good fit when
- A filter or response wrapper changes the contract and the export needs a rule.
- Controller docs are pushed to YApi or Postman from the IDE in one action.
- Class fields are converted to JSON, JSON5, YAML or properties.
- An agent lists project endpoints on request and exports them through the IDE's MCP.
Not a fit when
- The project is not on the JVM: the plugin parses Java, Kotlin, Scala and Groovy.
- You lack IntelliJ IDEA 2025.2 or newer: the main build targets it.
- Plain Spring endpoints already export without rules, and the skill is for custom conventions.
Example request
Check which endpoints EasyYapi would export from this module and add a rule for the shared authorization header.Limitations
The plugin runs inside IntelliJ IDEA 2025.2 and newer, and without the IDE the skill exports nothing. MCP tools are available only when the IDE's built-in MCP server is on. Exporting to YApi, Postman, Hoppscotch and ApiPost sends endpoint descriptions to the chosen platform, and the README marks Hoppscotch, OpenAPI and ApiPost as beta. The AGPL-3.0 license sets conditions on derivative works, and the plugin and skill install in separate steps.
How to disable. Remove the `easy-yapi-assistant` skill from the agent's skills directory and disable or uninstall the EasyApi plugin in IDE settings.
FAQ
How do I install the skill?
Run `npx skills add tangcent/easy-yapi -g -y`. If the agent cannot install skills, paste the prompt from the README, which fetches only the `skills/easy-yapi-assistant/` folder.
Where does the plugin export?
To YApi, Postman, Markdown, cURL and the IDE HTTP Client, and in beta also to Hoppscotch, OpenAPI and ApiPost.
Which frameworks does it understand?
Spring MVC, Spring Cloud OpenFeign, JAX-RS (Quarkus and Jersey) and gRPC. A rules mode covers other conventions.
What does MCP add?
With the IDE's MCP server on, an agent calls `easyapi_scan_endpoints` (read-only) and `easyapi_export` (export to YApi with no dialog).
How does the skill differ from the built-in assistant?
The built-in agent works through the IDE's PSI, while the skill reads project files directly and suits external assistants such as Cursor or Cline.
Discussion
No questions or reviews yet.
Related
SkillsSixteen Spring Boot skills: the agent explores the application first, then edits JPA, DTOs, REST, Security, Kafka and tests.
The official FastAPI skill, bundled with the package, teaching agents to write code for the installed version
Six skills for Java work: Spring Boot 4, Modulith checks, jSpecify, code review and the Progen project generator.
A set of Claude Code and Codex skills that teach the agent to write Spring Boot by your conventions and templates
A terminal REST client with YAML collections next to the code and a skill that lets the agent write and run requests itself
A set of 14 skills for Java Spring Boot, from requirements analysis and code generation to tests, review and Docker deployment.
README in short
The README centres on an IntelliJ plugin with API export, an endpoint explorer and field conversion. The Skills section covers the external skill and `npx skills add` install.