Compose Agent Skill
A skill for Jetpack Compose and Compose Multiplatform: the agent writes UI from references and checks it against androidx source
Low risk
We rate an entry low when it mostly gives the agent instructions and reference material.
Why this level
- The skill is made of references and source excerpts and runs nothing itself
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/compose-agent-skillDetects the agents on your machine, checks the risk and pins the version.
Other ways to install
Run in a terminal in the project folder
npx skills add aldefy/compose-skill --skill compose-expert -a claude-code -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 954ef54
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/aldefy/compose-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/compose-expert/
git -C "$tmp" checkout 954ef54ea32288fbc90745f012d09d7b791f0d8a
mkdir -p .claude/skills
cp -R "$tmp/skills/compose-expert" .claude/skills/compose-expertCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add aldefy/compose-skill --skill compose-expert -a cursor -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 954ef54
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/aldefy/compose-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/compose-expert/
git -C "$tmp" checkout 954ef54ea32288fbc90745f012d09d7b791f0d8a
mkdir -p .agents/skills
cp -R "$tmp/skills/compose-expert" .agents/skills/compose-expertCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add aldefy/compose-skill --skill compose-expert -a github-copilot -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 954ef54
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/aldefy/compose-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/compose-expert/
git -C "$tmp" checkout 954ef54ea32288fbc90745f012d09d7b791f0d8a
mkdir -p .github/skills
cp -R "$tmp/skills/compose-expert" .github/skills/compose-expertCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add aldefy/compose-skill --skill compose-expert -a codex -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 954ef54
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/aldefy/compose-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/compose-expert/
git -C "$tmp" checkout 954ef54ea32288fbc90745f012d09d7b791f0d8a
mkdir -p .agents/skills
cp -R "$tmp/skills/compose-expert" .agents/skills/compose-expertCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add aldefy/compose-skill --skill compose-expert -a gemini-cli -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 954ef54
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/aldefy/compose-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/compose-expert/
git -C "$tmp" checkout 954ef54ea32288fbc90745f012d09d7b791f0d8a
mkdir -p .agents/skills
cp -R "$tmp/skills/compose-expert" .agents/skills/compose-expertCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/aldefy/compose-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/compose-expert/
git -C "$tmp" checkout 954ef54ea32288fbc90745f012d09d7b791f0d8a
mkdir -p .devin/skills
cp -R "$tmp/skills/compose-expert" .devin/skills/compose-expertCommands for macOS and Linux, on Windows run them in Git Bash.
Formerly Windsurf.
Run in a terminal in the project folder
npx skills add aldefy/compose-skill --skill compose-expert -a cline -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 954ef54
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/aldefy/compose-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/compose-expert/
git -C "$tmp" checkout 954ef54ea32288fbc90745f012d09d7b791f0d8a
mkdir -p .cline/skills
cp -R "$tmp/skills/compose-expert" .cline/skills/compose-expertCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
npx skills add aldefy/compose-skill --skill compose-expert -a roo -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 954ef54
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/aldefy/compose-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/compose-expert/
git -C "$tmp" checkout 954ef54ea32288fbc90745f012d09d7b791f0d8a
mkdir -p .roo/skills
cp -R "$tmp/skills/compose-expert" .roo/skills/compose-expertCommands for macOS and Linux, on Windows run them in Git Bash.
A fork of Roo Code, same .roo folders.
Run in a terminal in the project folder
npx skills add aldefy/compose-skill --skill compose-expert -a opencode -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Without third-party tools, from commit 954ef54
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/aldefy/compose-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/compose-expert/
git -C "$tmp" checkout 954ef54ea32288fbc90745f012d09d7b791f0d8a
mkdir -p .agents/skills
cp -R "$tmp/skills/compose-expert" .agents/skills/compose-expertCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/aldefy/compose-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/compose-expert/
git -C "$tmp" checkout 954ef54ea32288fbc90745f012d09d7b791f0d8a
mkdir -p .agents/skills
cp -R "$tmp/skills/compose-expert" .agents/skills/compose-expertCommands for macOS and Linux, on Windows run them in Git Bash.
Run in a terminal in the project folder
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/aldefy/compose-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/compose-expert/
git -C "$tmp" checkout 954ef54ea32288fbc90745f012d09d7b791f0d8a
mkdir -p .agents/skills
cp -R "$tmp/skills/compose-expert" .agents/skills/compose-expertCommands for macOS and Linux, on Windows run them in Git Bash.
Install the skill in Claude Code: /plugin marketplace add aldefy/compose-skill, then /plugin install compose-expert. After that just ask about Compose and the skill loads on its own.
Other ways from the author
/plugin marketplace add aldefy/compose-skill
/plugin install compose-expertThis is third-party code. Review the repository files before installing.
What it does
The skill gives the agent a set of Jetpack Compose and Compose Multiplatform references plus real source snippets from androidx and compose-multiplatform-core. When the user asks about Compose, the agent uses the routing section in SKILL.md to pick the right reference: state, performance, navigation, modifiers, side effects, theming, animation, lists. For tricky API details it checks the bundled source instead of guessing. A review mode walks Compose code in a pull request against a checklist.
Who it is for. For Android and Kotlin Multiplatform developers who build Compose UI with a coding agent.
Good fit when
- The agent writes Compose code and confuses remember, state or modifier ordering
- You need a rule-based review of Compose in a pull request
- You work with Compose Multiplatform, TV or Material 3 motion and need current patterns
Not a fit when
- The project uses classic Views or another UI stack, not Compose
- You need backend or logic help unrelated to Compose UI
Example request
Review this Compose screen: is remember used correctly and is the modifier order rightLimitations
The skill provides knowledge and source checks but does not replace building and testing the project. References and source snippets reflect specific Compose versions and need updates over time. It requires no keys or paid accounts.
How to disable. Remove the compose-expert plugin via /plugin or delete the skill folder from the skills directory.
Security check
- The skill is made of references and source excerpts and runs nothing itself
README in short
The README explains that agents often produce Compose code that compiles but gets details wrong: bad remember usage, extra recompositions, deprecated navigation, hallucinated APIs. The skill fixes this with two layers: references for every major Compose topic and real source excerpts for verification. A routing section in SKILL.md maps a request to one reference. It installs as a plugin in Claude Code and Copilot CLI, with manual steps for other agents. MIT licensed.
SKILL.md
---
name: compose-expert
description: >
Compose and Compose Multiplatform expert for UI development across Android, Desktop,
iOS, and Web. Use whenever the user mentions Compose APIs (@Composable, remember,
LaunchedEffect, NavHost, MaterialTheme, LazyColumn, Modifier, recomposition),
Compose Multiplatform (commonMain, expect/actual, Res.*, ComposeUIViewController,
UIKitView, ComposeViewport), Android TV (tv-material, D-pad, focus, Carousel),
Material 3 motion, atomic design systems, design-to-code workflows, Paging 3, or
navigation. Activates Review Mode on GitHub PR URLs and review phrases ("review
this PR", "what's wrong with this"). Auto-detects Compose projects on
session_start. Backed by actual androidx/androidx and JetBrains/compose-multiplatform-core
source receipts. See "## When this skill applies" in SKILL.md for the full trigger
surface.
version: 2.4.0
---
## When this skill applies
The frontmatter `description:` is intentionally short to satisfy Codex / Copilot
CLI's 1024-character cap on that field. The full trigger surface
lives here so it stays available to Claude after the skill loads.
### Compose API mentions
`@Composable`, `remember`, `mutableStateOf`, `derivedStateOf`, `rememberSaveable`,
`LaunchedEffect`, `DisposableEffect`, `SideEffect`, `rememberCoroutineScope`,
`Scaffold`, `NavHost`, `NavController`, `MaterialTheme`, `ColorScheme`,
`Typography`, `LazyColumn`, `LazyRow`, `LazyVerticalGrid`, `HorizontalPager`,
`Modifier`, `Modifier.Node`, `recomposition`, `CompositionLocal`, `Style`,FAQ
Which agents does it work with?
Claude Code as a plugin, Copilot CLI via copilot plugin install, and Codex, Cursor, Gemini CLI and others following INSTALL.md.
Where do the source checks come from?
The skill bundles source excerpts from androidx/androidx and JetBrains/compose-multiplatform-core; the agent reads them when it needs to verify API behavior.
Related
An MCP server and CLI from Sentry for building, running and testing Xcode iOS and macOS projects from an AI agent
Paul Hudson's skill for reviewing and writing SwiftUI for iOS 26: deprecated APIs, data flow, navigation, accessibility, performance
Expo's official agent skills: building, deploying, updating and debugging Expo and EAS apps
An open phone agent model and framework: it reads the screen and taps through Android, HarmonyOS and iOS apps from a text command