Kotlin Agent Skills

AI agent skills for Kotlin

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.

How do Skills work?

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.

Skill naming conventions

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 Kotlin
• tooling - 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.

Installation

Using the skills CLI

Install skills from this repository:

npx skills add Kotlin/kotlin-agent-skills

See npx skills for more options.

Claude Code

claude plugin marketplace add Kotlin/kotlin-agent-skills

claude plugin install kotlin-agent-skills@Kotlin

Codex

In shell:

codex plugin marketplace add Kotlin/kotlin-agent-skills

Then inside codex invoke /plugins, search for kotlin-agent-skills, press 'Enter' and select 'Install plugin'.

Manual installation

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/

Kotlin documentation MCP server

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/mcp

For other agents, add an HTTP (streamable HTTP) MCP server with the same URL.

Repository layout

• skills/ - a directory where all skills are located
• plugins/kotlin-agent-skills/.mcp.json - MCP server configuration for the Claude Code and Codex plugins

Contributing

See CONTRIBUTING.md for more details.