AI agent skills for lumo-ui
A collection of AI agent skills for lumo-ui, a Gradle plugin that generates Jetpack Compose UI components directly into Android and Kotlin Multiplatform projects. Skills follow the Agent Skills standard, so the same skills/ folder works in Claude Code, Codex, Cursor, Gemini CLI and any other agent that reads SKILL.md.
The skill documents lumo-ui 1.2.5 and is checked against that release's plugin templates in CI. It tells agents to read your generated component files first, since you may have edited them.
Official docs: https://www.lumoui.com
Installation
Claude Code
claude plugin marketplace add burkido/lumo-ui-skills
claude plugin install lumo-ui-skills@lumo-ui-skills
Or, inside a session: /plugin install lumo-ui-skills --marketplace burkido/lumo-ui-skills.
To get new releases, run claude plugin update lumo-ui-skills@lumo-ui-skills, or turn on auto-update under Marketplaces in /plugin.
Codex
codex plugin marketplace add burkido/lumo-ui-skills
Then install lumo-ui from the plugin directory. Run codex plugin marketplace upgrade to pick up new releases.
Cursor
cursor-agent plugin marketplace add https://github.com/burkido/lumo-ui-skills
Then run cursor-agent, open /plugin, and install lumo-ui from the Marketplace tab. Teams can import this repository as a team marketplace from the Cursor dashboard instead.
Gemini CLI
gemini extensions install https://github.com/burkido/lumo-ui-skills --auto-update
Add --ref v1.0.0 to pin a release.
claude.ai and other agents
Every release attaches a lumo-ui.zip. Upload it to claude.ai under Settings > Capabilities > Skills, or unzip it into your agent's skills directory:
# from a clone of this repository
cp -r skills/lumo-ui .claude/skills/ # Claude Code, project scope
cp -r skills/lumo-ui .agents/skills/ # Codex and other agents that read .agents/skills
How do skills work?
Skills are self-contained folders that package instructions and resources for an AI agent to use on a specific task. 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. Agents load only the name and description up front and read the rest when a task needs it.
Repository layout
| Path | Contents |
|---|---|
| skills/ | All skill folders, one per skill. The single source of truth every agent reads |
| .claude-plugin/ | Claude Code plugin and marketplace manifests |
| plugin.json | Agent Plugins manifest, read by Codex |
| .agents/plugins/ | Codex marketplace |
| .cursor-plugin/ | Cursor plugin and marketplace manifests |
| gemini-extension.json | Gemini CLI extension manifest |
| scripts/validate.mjs | Checks skills against the spec and keeps manifest versions in sync |
| scripts/check-upstream.mjs | Checks the docs against lumo-ui's plugin templates |
| scripts/set-version.mjs | Sets the release version in every manifest and SKILL.md |
| skills/lumo-ui/evals/ | Test prompts and expected behaviour for the skill |
| AGENTS.md | Guidance for AI agents working on this repo (CLAUDE.md links to it) |
lumo-ui quick start
lumo-ui is a Gradle plugin, not a runtime library: it copies ready-to-use Kotlin source into your project.
# 1. Apply the plugin in root build.gradle.kts
# id("com.nomanr.plugin.lumo") version "LATEST"
# 2. Initialize
./gradlew lumo --init
# 3. Configure lumo.properties (generated by --init)
# 4. Generate theme files
./gradlew lumo --setup
# 5. Add components
./gradlew lumo --add Button
./gradlew lumo --add TextField
Latest plugin version: https://search.maven.org/artifact/com.nomanr/lumo
Contributing
See CONTRIBUTING.md for adding skills and how releases work.