aiui-dev
Develop and debug AIUI agents, Pages, Widgets, Agent Workers, built-in components, WXSS, and runtime APIs. Use when generating or reviewing AIUI .ink, app.json, page logic, UI, or API integrations.
How do I install this agent skill?
npx skills add https://github.com/yodaos-project/aiui --skill aiui-devIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a comprehensive and safe development guide for the AIUI platform by YodaOS. It documents standard platform capabilities, including AI-driven UI components and sensitive device APIs, which are necessary for the platform's functionality. No malicious patterns or security risks were detected in the instructions themselves.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
AIUI Development
Build AIUI agents from the current contracts in this skill. Do not assume an API, component, CSS property, browser behavior, or lifecycle merely because it exists on the Web or in WeChat Mini Programs.
Load Only What the Task Needs
- Read framework.md for project structure,
app.json, Page, Widget, Agent Worker, SFC, modules, resources, packaging, TypeScript,offload, or single-file Source updates. - Read events.md for lifecycle, interaction, key, focus, voice wakeup, head gesture, and environment-awareness events.
- Read components.md before using or reviewing built-in components and their attributes or events.
- Read wxss.md before writing styles, layout, selectors, animation, or custom fonts.
- For keyframes, animation events, text-triggered decorations, or 2D transforms, also read animation.md.
- Read monochrome-green.md only for the monochrome-green Rokid Glasses visual language.
- Read full-color.md for the Rokid Color full-color visual language and adaptive layouts.
- Read APIs index, then its matching domain file, before using runtime APIs.
- For recording source selection or microphone modes, read media APIs.
- For Widget or Agent Worker instance methods, read Widget API or Agent Worker API.
- Read and apply delivery checklist before declaring a generated or modified AIUI agent complete.
- Start from the matching scaffold when useful: minimal Page, minimal Widget, or minimal Agent Worker.
Do not load every reference for a narrow task. For example, an Agent Worker normally needs framework.md, events.md, and apis/agent-worker.md, but not Canvas or the full component catalog.
Core Authoring Rules
- Register App, Page, Widget, Component, and Agent Worker logic with
export default { ... }; do not useApp(),Page(),Widget(), or similar registration functions. - Use either a multi-file Page or a single
.inkPage for one route, never both. - A
.inkPage uses<script def>,<script setup>,<page>, and<style>. A Widget replaces<page>with<widget>. - Declare every Page, Widget, Agent Worker, and custom component in the appropriate configuration before using it.
- Declare required capabilities in
app.json.permissions; handle device authorization failures separately. - Treat Widget
familyas a size category. Use relative layout and never hardcode the root to the current Glasses pixel size. - Use
agentWorkers, not the removedworkersfield. Extend asynchronousonOpenwork synchronously withevent.waitUntil(promise). - Use data binding for rendered state and
this.setData()to update it. - Page
onReady()and componentlifetimes.ready()run once per instance after their first visible frame is presented; parsing or layout completion alone is insufficient. - Resolve packaged resources from project paths; do not invent filesystem or network access that the target does not expose.
- Treat conversation-flow cards as display-only unless the task explicitly targets an interactive full-screen Page or Widget.
Target and Design Choice
Before styling, determine the intended surface:
- Conversation-flow card: compact, display-only information.
- Full-screen Page: interactive agent UI.
- Widget: compact
1x1or1x2surface with Widget lifecycle. - Monochrome-green Rokid Glasses: apply
design/monochrome-green.mdafter the general WXSS rules. - Rokid Color: apply
design/full-color.mdafter the general WXSS rules. - Other displays: use theme tokens and task requirements; do not automatically apply the monochrome-green visual language.
Runtime API Workflow
- Open references/apis/index.md and select the domain.
- Confirm the exact constructor or method, parameters, return type, events, errors, permissions, and lifecycle in that domain reference.
- If the API is absent or the requested overload is not documented, inspect current Ink types or implementation rather than guessing.
- Keep capability checks and cleanup close to the code that acquires the resource.
Completion Checks
Run the AIUI agent delivery checklist. Report which executable checks ran, what they proved, and any target-device behavior that remains unverified. Do not call an agent runnable only because its files look structurally correct.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/yodaos-project/aiui/aiui-dev">View aiui-dev on skillZs</a>