Teaching an AI Agent to Build Kuikly Apps: CLI, Structured Errors, and Knowledge Feeding

Why Build This?

As a veteran client developer, the author felt client development lagged behind frontend/backend where a single AI assistant (CodeBuddy) handles the workflow. While IDEs add AI features, the client toolchain — project creation, compilation, debugging — remains locked in GUI interactions, not CLI-friendly or structured enough for AI agents to drive end-to-end.

The 2026 trend is clear: tools and frameworks must serve AI agents, not just humans. Kuikly already offers industry-leading native rendering via Kotlin Multiplatform (KMP), one codebase for Android, iOS, HarmonyOS, and more, plus dynamic updates. But it relied on an Android Studio plugin for project scaffolding, leaving the flow inaccessible to agents.

Core Approach: The "Kuikly App Builder" Skill

The author gave OpenClaw (nicknamed "little crayfish") a Skill called Kuikly App Builder that does three things:

Full CLI-ization of project creation, configuration, and build. Previously only an IDE plugin generated template projects; now a single command creates a complete Kuikly multi-platform project — shared module plus Android/iOS/HarmonyOS/H5 host apps — in one step.

Structured JSON output for all commands. Compilation failures no longer dump hundreds of lines of Gradle logs. Errors are parsed into structured data pinpointing file, line number, and suggested fixes. The agent reads this, locates the issue, edits code, and re-compiles — an automatic repair loop without human intervention.

Feeding Kuikly programming knowledge to the agent. Component APIs, common errors, version compatibility are packaged into Skill files loaded into the agent's working memory. A critical rule: "Do not write code from memory." Agents tend to hallucinate Kuikly APIs based on React or Flutter experience, causing compile errors. The Skill forces the agent to consult official docs and examples before coding. The exact instruction is shown in the article's diagram (image index 4).

The Skills used are from Tencent's recently open-sourced Kuikly AI skill library: https://github.com/Tencent-TDS/KuiklyUI-AI. Detailed guides are at https://kuikly.tds.qq.com/AI/.

Results

Results exceeded expectations. The agent not only assembles UI but also handles logic and network requests. The stock-market app in the opening screenshots is not a static demo — it makes real API calls to a free service; the author only supplied a valid API key.

After APK generation, the flow integrates with Tencent's internal cloud real-device platform for automatic deployment, cloud execution, and online testing (images index 5 and 6).

Current Limitations

The cloud environment sometimes cannot compile iOS, so Kuikly's multi-platform capability isn't fully exercised.

From a software-engineering perspective, only a minimal closed loop exists. The agent is essentially "free-range" — lacking end-to-end control from requirements to acceptance. This is exactly what harness engineering addresses; further harness exploration is needed for agent-driven Kuikly development.

Key Takeaways

If your tool or framework cannot be invoked by an AI agent, you may be losing half your future users. CLI-izing, structured output, and knowledge documentation — these three steps apply not just to Kuikly but to any internal framework or tool.

We have barely scratched the surface of the agent's potential. Current output is prototype/demo grade, but the path is open. Adding skills for bug debugging, performance analysis, and development-paradigm management will steadily grow the agent's capability, likely reaching or surpassing a "cross-platform app development expert" level soon.

Try It Yourself

Kuikly App Builder is published on ClawHub: https://clawhub.ai/ (search "Kuikly") and on SkillHub (China-optimized): https://skillhub.cn/. Install the Skill (or download and import into WorkBuddy or other Claw agents), then prompt the agent, e.g.:

"Use kuikly-app-builder skill to implement a check-in app with record keeping"

"Use kuikly-app-builder skill to write a beautiful calculator app"

"Use kuikly-app-builder skill to write a stock app"

Notes: still Beta; limited test coverage may yield bad cases — feedback welcome. Prefer models with strong coding ability; the model may not proactively emit files or screenshots, requiring extra turns. First run installs required tools automatically (image index 7).

About Kuikly

Kuikly is now open source. Repository: https://github.com/Tencent-TDS/KuiklyUI. Documentation: https://kuikly.tds.qq.com/Introduction/arch.html. It belongs to the Tencent Terminal Service Alliance (tds.qq.com). Related sites: https://tds.qq.com/ and https://framework.tds.qq.com/.