KuiklyUI-AI skill
Thirteen skills and two rule files for Kuikly, Tencent's Kotlin UI framework: components, animation, networking, profiling
- 138 ★ on the repository
- Last commit
Extended access
Why this level
- On invocation the skills clone the Tencent-TDS/KuiklyUI repository and run shell scripts for update checks
- The recomposition analyzer may run platform commands on its own to pull profiler logs from a device
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/kuiklyui-aiDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- On invocation the skills clone the Tencent-TDS/KuiklyUI repository and run shell scripts for update checks
- The recomposition analyzer may run platform commands on its own to pull profiler logs from a device
This is third-party code. Review the repository files before installing.
What it does
The KuiklyUI-AI repository from Tencent-TDS teaches an agent to build apps on Kuikly, a Kotlin Multiplatform framework with a shared UI layer for Android, iOS, HarmonyOS, H5 and mini programs. The skills folder holds 13 skills and the rules folder two rule files in .mdc format: kuiklyDSL.mdc for the classic DSL and kuiklyComposeDSL.mdc for Compose DSL. Some skills drive page development. kuikly-ui-framework suggests components, modules and layout, kuikly-animation covers declarative and imperative animation, kuikly-reactive-observer handles reactive state and the vfor and vif directives, kuikly-network-and-json covers HTTP requests and JSON, and kuikly-coroutines-threading covers threads and coroutines. Others extend the framework itself: kuikly-expand-view builds custom Views on top of native ones, kuikly-expand-api writes modules that talk to the platform, and kuikly-multi-module-config sets up multi-module projects. kuikly-recomposition-analyzer reads profiler_report.json and profiler_frames.jsonl from the Recomposition Profiler in three passes: the report summary, the frames, then the source code. It puts every component with more than 50 recompositions into its report.
Who it is for. Mobile developers on Kotlin Multiplatform who build interfaces with Kuikly in Cursor, Claude Code or CodeBuddy.
Good fit when
- A new Kuikly page with lists, buttons and routing where the agent mixes up imports and API calls
- You need to animate transform or opacity and choose between the declarative and imperative approach
- A Compose DSL app stutters and you hold a recomposition profile from the Profiler
- A submodule is being added to the project and KuiklyCoreEntry conflicts
- A platform feature missing from the core has to be wired in through a custom Module
Not a fit when
- The work is on another framework: the skills know only Kuikly components and modules
- You need Jetpack Compose code without Kuikly: the catalog has compose-skill and compose-performance-skills for that
- You have general Kotlin questions: the skills are tuned to the Kuikly API and add little beyond it
Example request
Build a Kuikly page with a list of cards and a button that opens a detail screen, taking imports and API calls from the docsLimitations
The author notes the repository is in development and skills are released gradually. SKILL.md texts are mostly in Chinese while the README is in English. kuikly-ui-framework clones the Tencent-TDS/KuiklyUI repository into references when invoked and runs an update check every 7 days, and kuikly-compose-ui-framework carries the same scripts, so git and GitHub access are required. The README lists 12 skills while the folder holds 13: kuikly-compose-ui-framework is missing from the table. GitHub did not recognize the license.
How to disable. Delete the kuikly-* folders from the agent's skills directory and remove the rule files from `.cursor/rules/`, `.codebuddy/rules/` or `CLAUDE.md`. The source clone sits in references inside the skill folder and goes with it.
FAQ
How do I install the Kuikly skills in Cursor or Claude Code?
`npx skills add Tencent-TDS/KuiklyUI-AI/skills` installs every skill in the skills folder and `npx skills update Tencent-TDS/KuiklyUI-AI/skills` updates them. The rule files are copied separately.
How does kuiklyDSL.mdc differ from kuiklyComposeDSL.mdc?
The first file sets rules for the classic Kuikly DSL with attr and event blocks, the second for Compose DSL. Choose by your project's DSL. Cursor reads .mdc as is from `.cursor/rules/`, while for Claude Code the rule text goes into `CLAUDE.md` or is referenced as `@rules/kuiklyDSL.mdc`.
Where does the analyzer get recomposition data?
From profiler_report.json and profiler_frames.jsonl, which the RecompositionProfiler writes after start() and stop() calls or the Profiler Overlay buttons. The skill looks in `./profiler_logs/` and `./profiler_report.json`, then tries to pull them from a device, and without data asks you to collect them. With fewer than 30 frames it warns and asks whether to continue.
What is kuikly-visibility-exposure for?
The skill works with the didAppear, didDisappear, willAppear, willDisappear and appearPercentage events to count component impressions while scrolling.
Where does the skill get the exact Kuikly API?
From the Tencent-TDS/KuiklyUI clone in references: documentation, core sources, demos and a public class reference. A top-priority rule forbids writing code from memory.
Discussion
No questions or reviews yet.
Related
SkillsA skill for Compose UI on the Miuix library in Xiaomi HyperOS style: component choice, themes, navigation and source-checked APIs
21 skills for Android and KMP in Claude Code, Codex and Copilot CLI: Compose, coroutines, Flow, networking, storage, Gradle
An Android skill covering modular architecture, Compose, Material 3, accessibility and Kotlin migrations.
Skills for Kotlin, Jetpack Compose and Android: state and effects, performance, Flow, testing, benchmarks, Gradle and PR workflows
Official set of 30 skills from the Android team: Jetpack Compose, AGP 9 upgrade, R8, Perfetto profiling, Navigation 3, CameraX, Google Play policies
A skill for Jetpack Compose and Compose Multiplatform: the agent writes UI from references and checks it against androidx source
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| KuiklyUI-AI (this card) | yes | 138 | |
| Compose Performance Skills | no | 530 | 26 skills on Jetpack Compose performance, while this covers Kuikly and its DSL, including recomposition analysis |
| Compose Skill | no | 306 | a skill for Jetpack Compose and Compose Multiplatform from androidx references, while this set works with the Kuikly framework |
README in short
The README warns that the repository is in development. It has two parts: a rules table with CodeBuddy instructions and a summary for Cursor, Claude Code and other tools, then a skills table with descriptions plus install and update commands.
README badge
Original SKILL.md
---
name: kuikly-ui-framework
description: Kuikly UI 框架开发助手（传统 Kuikly DSL）。帮助使用 Kuikly 组件（View、Text、Button、List、Image、Modal、ActionSheet、Input、Scroller、Tabs 等 UI 组件）和模块（Router、Network、SP、Notify 等系统模块），自动提供正确的 import 语句、API 使用方法和完整代码示例。适用场景：Kuikly 页面开发、组件使用、布局实现、事件处理、FlexBox 布局、响应式状态管理、动画效果、页面路由跳转、网络请求、列表渲染、自定义组件/模块扩展、Kuikly 编码问题、KuiklyUI 开发。如需使用 Compose DSL 语法，请使用 kuikly-compose-ui-framework skill。
---
# Kuikly UI 框架开发助手
你是 Kuikly UI 框架开发专家。Kuikly 是基于 Kotlin MultiPlatform(KMP) 构建的跨端开发框架，利用 KMP 逻辑跨平台能力，抽象出通用的跨平台 UI 渲染接口，复用平台的 UI 组件，具有轻量、高性能、可动态化等优点。
本 skill 聚焦于**传统 Kuikly DSL**（`attr { }` / `event { }` 语法）开发。如需使用 Compose DSL 语法，请使用 `kuikly-compose-ui-framework` skill。
## 自动更新机制
**每次被调用时，请先执行以下检查流程：**
1. **检查 references/KuiklyUI 目录是否存在**，如不存在：
```bash
mkdir -p "${SKILL_DIR}/references"
cd "${SKILL_DIR}/references"
git clone https://github.com/Tencent-TDS/KuiklyUI
```
2. **检查是否需要更新**（仓库已存在时）：
```bash
bash "${SKILL_DIR}/scripts/check-update.sh"
```
3. **如果需要更新**（脚本返回退出码 1）：
```bash
bash "${SKILL_DIR}/scripts/update-repository.sh"
```
更新策略：自动检查周期 7 天，仓库地址 https://github.com/Tencent-TDS/KuiklyUI ，更新记录文件 `${SKILL_DIR}/scripts/.last-update`。更新失败不阻塞正常使用。
## 参考资源结构
`references/` 目录包含：
### 官方文档 (`references/KuiklyUI/docs/`)
- **API 组件文档**: `docs/API/components/`