A collection of AI agent skills useful for projects using the Kotlin language. Skills are following the Agent Skills standard, see agentskills.io for more information.
In practice, skills are self-contained folders that package instructions, scripts, and resources together for
an AI agent to use on a specific use case. Each folder includes a SKILL.md file with YAML
frontmatter (name and description) followed by the guidance your coding agent follows while the skill is active.
All skills in the repository should follow the following naming convention: kotlin-<category>-<functional-name>.
<category> here is one of predefined categories. Current categories are:
backend- server-side development skills, such as correct use of Spring, JPA, and other backend frameworks with Kotlintooling- any tooling related skills, for example build tooling one
Please open an issue to add additional categories.
<functional-name> should be a short, descriptive name of the skill, using kebab-case naming convention.
Install skills from this repository:
npx skills add Kotlin/kotlin-agent-skillsSee npx skills for more options.
claude plugin marketplace add Kotlin/kotlin-agent-skillsclaude plugin install kotlin-agent-skills@KotlinIn shell:
codex plugin marketplace add Kotlin/kotlin-agent-skillsThen inside codex invoke /plugins, search for kotlin-agent-skills, press 'Enter' and select 'Install plugin'.
Copy the desired skill folder from skills into the skills directory of your agent, for example:
cp -r skills/kotlin-tooling-agp9-migration .claude/skills/The Claude Code and Codex plugins also include the Kotlin documentation MCP server (https://mcp.kotlinlang.org/mcp).
It lets your agent search the documentation on kotlinlang.org and read
full documentation pages. The server is enabled automatically when you install the plugin.
The skills CLI and manual installation copy only the skills. To add the server yourself:
# Claude Code
claude mcp add --transport http kotlinlang https://mcp.kotlinlang.org/mcp
# Codex
codex mcp add kotlinlang --url https://mcp.kotlinlang.org/mcpFor other agents, add an HTTP (streamable HTTP) MCP server with the same URL.
- skills/ - a directory where all skills are located
- plugins/kotlin-agent-skills/.mcp.json - MCP server configuration for the Claude Code and Codex plugins
See CONTRIBUTING.md for more details.
