跳到主要内容
Supermarket
返回能力市场
Claude Skill
design
NOASSERTION

compose-skill

Jetpack Compose Agent Skill — AI-powered coding guidance with actual androidx/androidx source code receipts. Works with Claude Code, Codex CLI, Gemini CLI, Cursor, Copilot, Windsurf, and more.

aldefyaldefy
82/ 100

公开评测 · 综合采用结论

证据充分,整体质量与安全表现优秀

查看评测依据 查找我项目的报告基于公开项目证据,非安全认证或安装推荐
597stars
39forks
最近更新 3个月前
评测生成时间(北京时间)
本报告引擎
v3.10.0
当前引擎
v3.17.3

本报告与当前引擎使用不同规则;原分数不会自动更新,不同版本的分数不宜直接对比。

重新评测此项目

进入后确认来源与额度,提交才会创建任务。

代码版本未记录或记录无效,无法核对本报告的 commit 与送评文本;不会用当前项目代码回填历史记录。

Evaluation report

综合采用结论

82
B
满分 100 · 静态采用参考
值得推荐低风险
决策摘要

证据充分,整体质量与安全表现优秀

88%
高置信度
83
文档
100
安全
83
质量
72
活跃
46
采用
  • 基础评测完成+25/25确定性评分与静态安全扫描已完成
  • README 有效证据+25/2514,719 个去重后的有效字符
  • 独立证据来源+8/202 类非重复证据,重复文件不叠加
  • 仓库元数据+10/10已取得仓库状态与采用数据
  • 活跃记录+5/5已取得最近提交时间
  • AI 复核+15/15已完成结构化 AI 证据复核

本报告评了什么

综合分用于静态采用筛选,不是任务成功率,也不代表使用 Skill 后的能力提升。

静态检查范围
记录 2 个文件 · 36,926 字符
只检查采集到的受限文本与已知风险模式;未读取的脚本、依赖和运行环境不在结论内。
AI 内容复核
已使用
复核送评文本的说明和设计,不是安装测试或实际任务执行。记录缺失时不推断已使用或未使用。
真实任务效果
本报告未提供实测证据
没有使用/不使用 Skill 的任务对照、重复运行或耗时与 token 成本结果。采用前仍需在隔离环境验证自己的任务。

脚本引用覆盖

脚本引用覆盖记录不可得;不推断没有引用或已经检查。

How it works · 流程图

Compose技能工作流程

README中'How it works'部分展示了从用户提问到参考文件选择的流程,属于单一任务的连续步骤。

AI 提取 · 证据约束

左右滑动查看完整图示

Compose技能工作流程README中'How it works'部分展示了从用户提问到参考文件选择的流程,属于单一任务的连续步骤。触发路由验证基于源码用户提问输入读取SKILL.md处理选择参考文件处理查阅源码处理生成回答输出
图示依据
  • • README中'How it works'的ASCII图
  • • Quick example步骤1-5
  • • Layer 1和Layer 2描述
五维表现
该技能针对AI编码工具对Compose理解不足的问题,提供24份指南和6份源码,价值明确。安装步骤覆盖多工具,但缺少输出示例和错误处理,设计上依赖外部源码,需注意版本同步。
质量证据
  • README中'What's covered'表格列出24个主题
  • 安装章节提供Claude Code、Codex等具体命令
  • 文件结构展示SKILL.md和references/目录
  • Quick example展示LazyColumn问题处理流程
  • License部分声明MIT和Apache 2.0
采用建议
优势
  • 问题与用途描述
  • 有效 README
  • 安装或接入步骤
  • 可执行示例
  • 未发现已知高风险模式
关注点
  • 缺少输出或结果说明
  • 缺少错误处理或排障
  • 缺少输出或结果说明,无法验证实际效果
  • 无错误处理或排障指南
  • 源码文件可能随版本更新,需维护
适合

使用AI编码工具开发Compose应用的开发者、需要准确API参考的Compose Multiplatform项目、希望减少代码幻觉的团队、需要跨平台Compose指导的场景

不建议直接用于

不需要AI辅助的纯手动开发、对Compose已有深入理解的专家、需要实时在线API查询的场景

也有自己的公开项目?先免登录查已有报告;没有报告时,可保留地址继续登录评测。

查找我项目的报告 →
文档证据
83/100
问题与用途描述10 分
有效 README12 分
安装或接入步骤14 分
可执行示例16 分
输入、参数或工具说明11 分
输出或结果说明9 分
限制、权限或边界12 分
错误处理或排障8 分
许可证信息5 分
结构化章节3 分
安全证据
低风险
未发现已知高风险模式

静态扫描不是安全保证,生产接入前仍应人工复核权限和数据边界。

优先改进清单
  1. 01补充输出或结果说明
  2. 02补充错误处理或排障
方法、证据与局限展开
数据来源

GitHub Repository API

扫描范围

2 个文件 · 36,926 字符

评测引擎

v3.10.0 · AI 内容复核:已使用(deepseek-chat)

局限
  • 静态评测不会安装或执行项目代码
  • 安全扫描基于高信号文件与已知模式,不能替代人工审计
  • 流行度只反映采用程度,不代表安全或工程质量

30 天热度趋势

README

Jetpack Compose logo

Compose Agent Skill

Make your AI coding tool actually understand Compose — Android, Desktop, iOS, and Web.
Backed by real source code from androidx/androidx and compose-multiplatform-core — not vibes.

GitHub stars Setup time License Compose version CMP version Kotlin version


See the difference

Same prompt. Same model. The only variable is whether this skill is installed.

You: "Add a counter to this composable."

❌ Without the skill✅ With the skill
@Composable
fun Counter() {
    // recreated every recomposition —
    // count resets to 0 constantly
    var count = mutableStateOf(0)
    Button(onClick = { count.value++ }) {
        Text("Count: ${count.value}")
    }
}

State is recreated on every recomposition — the counter silently resets. Also boxes the Int.

@Composable
fun Counter() {
    // survives recomposition, no boxing
    var count by remember { mutableIntStateOf(0) }
    Button(onClick = { count++ }) {
        Text("Count: $count")
    }
}

remember keeps state across recomposition; mutableIntStateOf avoids boxing. Verified against androidx source.

You: "Set up navigation between two screens."

❌ Without the skill✅ With the skill
// string routes — no type safety,
// args stringly-typed, deprecated pattern
NavHost(nav, startDestination = "home") {
    composable("home") { Home(nav) }
    composable("detail/{id}") { back ->
        Detail(back.arguments?.getString("id"))
    }
}
// type-safe routes, compiler-checked args
@Serializable object Home
@Serializable data class Detail(val id: String)

NavHost(nav, startDestination = Home) {
    composable<Home> { Home(nav) }
    composable<Detail> { entry ->
        Detail(entry.toRoute<Detail>().id)
    }
}

The difference is source-backed grounding — the agent checks real androidx/androidx and compose-multiplatform-core signatures instead of guessing. See how it works ↓


Install

This skill is distributed as a plugin. See docs/INSTALL.md for per-host instructions:

  • Claude Code: /plugin marketplace add aldefy/compose-skill → /plugin install compose-expert (one step on Claude Code 2.1.275+: /plugin install compose-expert --marketplace aldefy/compose-skill)
  • Copilot CLI: copilot plugin install aldefy/compose-skill
  • Codex CLI: manual install — see INSTALL.md.

Already installed manually? See docs/MIGRATION.md.

Updates

New versions are published as GitHub Releases with migration notes. Run /plugin update (Claude Code) or copilot plugin update aldefy/compose-skill (Copilot) to pick them up.


The problem

AI coding tools generate Compose code that compiles but gets the details wrong. Incorrect remember usage, unstable recompositions, broken modifier ordering, deprecated navigation patterns, hallucinated APIs that don't exist. They guess at behavior instead of knowing it.

This skill fixes that by giving your AI assistant two things:

  1. 35 reference guides covering every major Compose topic — including Compose Multiplatform, A2UI, AppState, Remote Compose, adaptive layouts and input, Android XR, Wear OS, Media3, Android TV, Material 3 motion, Paging 3, Nav 2 → Nav 3 migration, and production crash patterns
  2. 6 source code files pulled directly from androidx/androidx and compose-multiplatform-core so the agent can check how things actually work

What changes when you install it

AreaWithout the skillWith it
StateUses remember { mutableStateOf() } everywhere, even when derivedStateOf or rememberSaveable is the right callPicks the right state primitive for each situation
PerformanceGenerates code that recomposes every frameApplies stability annotations, deferred reads, key {} on lists
NavigationString-based routes (deprecated)Type-safe routes with @Serializable route classes
ModifiersRandom ordering, misses clickable before padding bugsCorrect ordering with reasoning
Side effectsWrong coroutine scope, bad LaunchedEffect keysCorrect effect selection and lifecycle-aware keys
APIsHallucinates parameters that don't existChecks against actual source before suggesting
MultiplatformUses Android-only APIs in shared codeUses expect/actual, Res.* resources, platform-correct patterns
Design-to-codeLiteral Figma node translation, wrong modifier orderingSemantic M3 components, correct ordering, theme tokens
Crash safetyNo defensive patternsGuards against zero-size DrawScope, duplicate keys, stale derivedStateOf

What's covered

TopicWhat the agent learns
State managementremember, mutableStateOf, derivedStateOf, rememberSaveable, state hoisting, snapshotFlow
View compositionStructuring composables, slot APIs, @Preview patterns, extraction rules
PerformanceRecomposition skipping, @Stable/@Immutable, deferred reads, baseline profiles, benchmarking
NavigationType-safe routes, NavHost, deep links, shared element transitions, back stack
Animationanimate*AsState, AnimatedVisibility, Crossfade, updateTransition, shared transitions, 9 recipes (shimmer, swipe-to-dismiss, etc.), gesture-driven patterns, Figma curve mapping
Lists and scrollingLazyColumn/LazyRow/LazyGrid, Pager, key {}, contentType, scroll state
Side effectsLaunchedEffect, DisposableEffect, SideEffect, rememberCoroutineScope
ModifiersOrdering rules, custom modifiers, Modifier.Node migration
ThemingMaterialTheme, ColorScheme, dynamic color, Typography, shapes, dark theme
AccessibilitySemantics, content descriptions, traversal order, touch targets, TalkBack
CompositionLocalsLocalContext, LocalDensity, custom locals, when to use vs. parameter passing
Deprecated patternsRemoved APIs, migration paths from older Compose versions
Styles API (experimental)Style {}, MutableStyleState, Modifier.styleable(), composition, theme integration, alpha06 gotchas
Design-to-codeComposable decomposition algorithm, Figma property mapping, spacing ownership, modifier ordering, design tokens
Production crash playbook6 crash patterns with root cause + fix, defensive patterns, production state/performance rules
Compose MultiplatformCMP architecture, expect/actual, Res.* resources, API availability matrix, migration guide
Platform specificsDesktop (Window, Tray, MenuBar), iOS (UIKitView, gotchas), Web/WASM (canvas limitations)
TV ComposeTV Material3 (Surface, Cards, Carousel, NavigationDrawer, TabRow), focus system, D-pad navigation, theming, immersive list, TVProvider
M3 MotionAll duration tokens (DurationShort1–4, DurationMedium1–4, DurationLong1–4, DurationExtraLong1–4), easing tokens with CubicBezierEasing values, MotionScheme API (defaultSpatialSpec, defaultEffectsSpec), Compose API mapping, decision tree, PR review flags
Atomic design5-level hierarchy (tokens, atoms, molecules, organisms, templates) mapped to Compose, M3 wrapper patterns, custom atom patterns, slot API contracts, token layer, anti-patterns
Paging 3PagingSource, Pager, PagingConfig, LazyPagingItems, LoadState UI handling, flatMapLatest for filter changes, RemoteMediator offline-first, MVI dual-flow pattern, asSnapshot/TestPager, full anti-pattern table
Nav 2 → Nav 3 migrationConceptual shifts (you own the back stack), mechanical migration steps (NavKey, rememberNavBackStack, NavDisplay, entry-scoped ViewModels, deep-link parsing), original "Choosing Nav 2 vs Nav 3" decision guide with the CMP 1.10+ polymorphic-serialisation caveat
A2UICatalog capability boundaries, message processors, native agent-generated surfaces, progressive rendering, testing and security
AppStateHeadless Transform, listener, StateStore, DataStore persistence, and choosing between snapshot state and Flow
Adaptive layouts and inputMediaQuery, Grid, FlexBox, Navigation 3 scenes, keyboard, mouse, trackpad, and indirect input
Remote ComposeRemote documents and players, capability profiles, expressions, Glance and Wear Widgets
Modern graphicsMesh gradients, wide gamut, polygon morphs, progressive/backdrop blur, and graphics performance
Android XR and WearCompose Glimmer, projected activities, spatial UI, XR accessibility, Wear Material 3 and Wear Widgets
Media3 ComposePlayer ownership, customizable Compose controls, Cast handoff, lifecycle and form-factor input
Source codeActual .kt from androidx/androidx and compose-multiplatform-core for runtime, UI, foundation, material3, navigation, CMP

How it works

You ask about Compose
        |
        v
  AI reads SKILL.md (workflow + checklists)
        |
        v
  Consults the right reference file
        |
        +-- state-management.md
        +-- performance.md
        +-- navigation.md
        +-- design-to-compose.md
        +-- production-crash-playbook.md
        +-- multiplatform.md
        +-- platform-specifics.md
        +-- tv-compose.md
        +-- ... (20 guides total)
        |
        +-- source-code/
              +-- runtime-source.md
              +-- material3-source.md
              +-- cmp-source.md
              +-- ... (6 source files)

Layer 1: guidance docs (35 files) — practical references with patterns, pitfalls, and do/don't examples. The skill's ## Quick Routing section maps task signals to a single file so the agent lands on the right reference in one read.

Layer 2: source code receipts (6 files) — the actual Kotlin source from androidx/androidx and compose-multiplatform-core. When the agent needs to verify an implementation detail rather than guess, it reads these.

File structure

skills/compose-expert/
├── SKILL.md                              # Main workflow + checklists
└── references/
    ├── state-management.md               # State, remember, hoisting, derivedStateOf
    ├── view-composition.md               # Structuring composables, slots, previews
    ├── modifiers.md                      # Modifier ordering, custom modifiers, Modifier.Node
    ├── side-effects.md                   # LaunchedEffect, DisposableEffect, SideEffect
    ├── composition-locals.md             # CompositionLocal, LocalContext, custom locals
    ├── lists-scrolling.md                # LazyColumn/Row/Grid, Pager, keys, contentType
    ├── navigation.md                     # NavHost, type-safe routes, deep links (Nav 2)
    ├── navigation-migration.md           # Nav 2 → Nav 3 migration + decision guide
    ├── paging.md                         # Paging 3 core: PagingSource, Pager, LazyPagingItems
    ├── paging-offline.md                 # RemoteMediator, offline-first, LoadState gotchas
    ├── paging-mvi-testing.md             # MVI dual-flow pattern, asSnapshot, TestPager
    ├── animation.md                      # animate*AsState, AnimatedVisibility, transitions
    ├── theming-material3.md              # MaterialTheme, ColorScheme, dynamic color
    ├── performance.md                    # Recomposition, stability, benchmarking
    ├── accessibility.md                  # Semantics, content descriptions, testing
    ├── deprecated-patterns.md            # Removed APIs, migration paths
    ├── styles-experimental.md           # Styles API (@ExperimentalFoundationStyleApi)
    ├── design-to-compose.md             # Figma/screenshot decomposition, property mapping
    ├── production-crash-playbook.md     # Crash patterns, defensive coding, production rules
    ├── multiplatform.md                 # CMP architecture, expect/actual, Res.*, migration
    ├── platform-specifics.md            # Desktop, iOS, Web/WASM platform APIs and gotchas
    ├── agentic-ui-a2ui.md               # A2UI catalogs, surfaces, events, safety
    ├── appstate.md                      # Transform, listener, StateStore
    ├── text-editing.md                  # TextFieldState and transformations
    ├── adaptive-layout-input.md         # MediaQuery, Grid/FlexBox, non-touch input
    ├── remote-compose.md                # Remote documents, players, Glance/Wear
    ├── graphics-modern.md               # Mesh gradients, shapes, blur, wide gamut
    ├── xr-compose.md                    # Glimmer, projected and spatial UI
    ├── wear-compose.md                  # Wear Material 3 and Wear Widgets
    ├── media3-compose.md                # Media3 UI Compose and player lifecycle
    ├── tv-compose.md                    # Android TV: tv-material, Carousel, focus, D-pad
    ├── atomic-design.md                 # Atomic design system: tokens, atoms, molecules, organisms, templates
    └── source-code/                      # Actual .kt source
        ├── runtime-source.md             # Composer, Recomposer, State, Effects
        ├── ui-source.md                  # AndroidCompositionLocals, Modifier, Layout
        ├── foundation-source.md          # LazyList, BasicTextField, Gestures
        ├── material3-source.md           # MaterialTheme, all M3 components
        ├── navigation-source.md          # NavHost, ComposeNavigator
        └── cmp-source.md                # Window, UIKitView, ComposeViewport, Resources

Setup

The skill is just markdown files. Every tool below reads the same content. Pick yours.


Claude Code

Skills are file-based — Claude Code discovers them automatically from ~/.claude/skills/ (personal) or .claude/skills/ (project-specific).

Personal skill (available in all your projects):

Clone the repo and copy the skill into your personal skills directory:

git clone https://github.com/aldefy/compose-skill.git /tmp/compose-skill
mkdir -p ~/.claude/skills
cp -r /tmp/compose-skill/skills/compose-expert ~/.claude/skills/

Project-specific skill (just one project):

Clone the repo and copy the skill into your project's .claude/skills directory:

git clone https://github.com/aldefy/compose-skill.git /tmp/compose-skill
mkdir -p .claude/skills
cp -r /tmp/compose-skill/skills/compose-expert .claude/skills/

No CLI command or config file needed. Claude Code picks up SKILL.md from these directories automatically and triggers when you mention Compose, @Composable, remember, LazyColumn, NavHost, etc.


Codex CLI (OpenAI)

Add an AGENTS.md file to your project root:

# AGENTS.md

## Jetpack Compose
For all Compose/Android UI tasks, follow the instructions in
`skills/compose-expert/SKILL.md` and consult the reference
files in `skills/compose-expert/references/` before answering.

Add the skill to your project as a submodule:

git submodule add https://github.com/aldefy/compose-skill.git .compose-skill

Codex discovers AGENTS.md files automatically from the git root down to the current directory.


Gemini CLI (Google)

Add to GEMINI.md in your project root:

# GEMINI.md

## Jetpack Compose Expert
For all Jetpack Compose tasks, follow the workflow and checklists in
`skills/compose-expert/SKILL.md`.

Before answering any Compose question, consult the relevant reference:
- State management -> `skills/compose-expert/references/state-management.md`
- Performance -> `skills/compose-expert/references/performance.md`
- Navigation -> `skills/compose-expert/references/navigation.md`
- (see SKILL.md for the full topic -> file mapping)

For implementation details, check actual source code in
`skills/compose-expert/references/source-code/`.

Add as a submodule:

git submodule add git@github.com:aldefy/compose-skill.git .compose-skill

Google Antigravity

Antigravity automatically discovers skills from workspace or global skill folders. The skills/compose-expert directory acts as a complete, ready-to-use Antigravity skill since it contains the needed SKILL.md file with a YAML frontmatter description.

Workspace skill (project-specific):

# Clone the repo
git clone https://github.com/aldefy/compose-skill.git /tmp/compose-skill

# Copy into your project's .agents/skills directory
mkdir -p .agents/skills
cp -r /tmp/compose-skill/skills/compose-expert .agents/skills/compose-expert

Global skill (available in all your projects):

# Clone the repo
git clone https://github.com/aldefy/compose-skill.git /tmp/compose-skill

# Copy into your global Antigravity skills directory
mkdir -p ~/.gemini/antigravity/skills
cp -r /tmp/compose-skill/skills/compose-expert ~/.gemini/antigravity/skills/compose-expert

Cursor

Create .cursor/rules/compose-skill.mdc:

---
description: Jetpack Compose expert guidance
globs: **/*.kt
---

Follow the instructions in `skills/compose-expert/SKILL.md`
for all Compose-related code. Consult reference files in
`skills/compose-expert/references/` before suggesting patterns.

Or paste the contents of SKILL.md into Settings > Rules for AI.


GitHub Copilot

Add to .github/copilot-instructions.md:

## Jetpack Compose
For Compose/Android UI work, follow the skill instructions in
`skills/compose-expert/SKILL.md`. Consult reference files in
`skills/compose-expert/references/` for patterns, pitfalls,
and source-code-backed guidance.

Windsurf

Create .windsurf/rules/compose-skill.md in your project root:

For all Jetpack Compose tasks, follow the workflow in
`skills/compose-expert/SKILL.md` and consult the reference
files in `skills/compose-expert/references/` before answering.

Note: The legacy .windsurfrules file also works but .windsurf/rules/ is the current approach.


Amazon Q Developer

Add to .amazonq/rules/compose.md:

For all Jetpack Compose tasks, follow the workflow in
`skills/compose-expert/SKILL.md` and consult the reference
files in `skills/compose-expert/references/` before answering.

Any other AI coding tool

It's just markdown. Clone this repo into your project (or add as a submodule), then point your tool's instruction file at skills/compose-expert/SKILL.md. The agent reads SKILL.md for the workflow and pulls from references/ as needed.

Quick example

After setup, just talk to your AI assistant normally:

"My LazyColumn is janky when scrolling — help me fix it"

What happens:

  1. Agent reads SKILL.md for the workflow
  2. Pulls in references/lists-scrolling.md and references/performance.md
  3. Checks your code for missing key {}, unstable item types, heavy compositions in item blocks
  4. If something's unclear, verifies against references/source-code/foundation-source.md
  5. Gives you a fix based on the actual LazyList implementation

No hallucinated APIs. No guessed behavior.

Source

Source code comes from androidx/androidx and JetBrains/compose-multiplatform-core under Apache License 2.0. The guidance docs are original analysis of those sources plus official documentation.

Contributing

PRs welcome, especially:

  • Additional platform-specific gotchas and workarounds
  • New animation recipes for common UI patterns
  • Production crash patterns from real apps
  • Corrections based on newer Compose/CMP releases
  • Auto-update tooling for tracking new releases

License

MIT — see LICENSE.

Source code from androidx/androidx is Apache License 2.0, copyright The Android Open Source Project. Source code from compose-multiplatform-core is Apache License 2.0, copyright JetBrains s.r.o.