# Kmp Architecture Footguns (agent skill)

> Kmp Architecture Footguns is an agent skill (a SKILL.md file) from maxrave-dev/kotlin-footguns. Kotlin Multiplatform structure and language traps: module splits, expect/actual, Koin and ViewModel scoping, layers, version catalogs, erased overloads, Char and string-resource formatting limits. It works with Claude Code, Codex, Cursor and GitHub Copilot and has 1,652 GitHub stars across a repository of 2 listed skills.

Kotlin Multiplatform structure and language traps: module splits, expect/actual, Koin and ViewModel scoping, layers, version catalogs, erased overloads, Char and string-resource formatting limits. Use when shaping modules or DI, when a format specifier renders verbatim, or code misbehaves on one platform. 25 traps mined from a production Kotlin and Compose Multiplatform app, one short file each under references/.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/maxrave-dev/kotlin-footguns |
| Skill path | skills/kmp-architecture-footguns/SKILL.md |
| Skill name | kmp-architecture-footguns |
| GitHub stars | 1,652 |
| Installs on skills.sh | not listed |
| License | GPL-3.0 |
| Skills in repo | 2 |
| Plugin marketplace | maxrave |
| Official | no |
| Works with | Claude Code, Codex, Cursor, GitHub Copilot |
| Category | Coding |
| Last commit | Oct 18, 2026 |

## When it triggers

- Use when shaping modules or DI, when a format specifier renders verbatim, or code misbehaves on one platform.

## Add this skill

### Claude Code

```sh
/plugin marketplace add maxrave-dev/kotlin-footguns
/plugin install kotlin-footguns@maxrave
```

In the Claude apps, zip the skill folder and upload it under Customize > Skills > + > Upload a skill (code execution must be on).

### ChatGPT / Codex

```sh
git clone --depth 1 https://github.com/maxrave-dev/kotlin-footguns.git
cp -r kotlin-footguns/skills/kmp-architecture-footguns .agents/skills/kmp-architecture-footguns   # repo; ~/.agents/skills for all projects
```

### Cursor

```sh
git clone --depth 1 https://github.com/maxrave-dev/kotlin-footguns.git
cp -r kotlin-footguns/skills/kmp-architecture-footguns .cursor/skills/kmp-architecture-footguns   # project; ~/.cursor/skills for all projects
```

Sources (checked 2026-10-07): https://code.claude.com/docs/en/skills, https://support.claude.com/en/articles/12512180-using-skills-in-claude, https://learn.chatgpt.com/docs/build-skills, https://cursor.com/docs/context/skills

---

Canonical page: https://appsgit.com/skills/maxrave-dev-kmp-architecture-footguns
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed daily.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.