Universal Agent Skill Marketplace for ZK Framework

A cross-platform AI agent skill marketplace for ZK Framework development. Supported by Claude Code, Gemini CLI, and GitHub Copilot/Cursor.

Features

• Multi-Tool Support: Use the same skills across different AI assistants.
• ZK Expertise: Specialist guidance for ZK 9/10, MVC, and MVVM patterns.
• Visual Analysis: Convert UI screenshots or mockups directly into ZUL code.
• Automated Validation: Integrated scripts to verify ZUL structural and formatting rules.

📦 Marketplace Index

The marketplace.json file provides a machine-readable index of all available skills, including their versions, tags, and installation metadata. Use this if you need to manually configure agent skills in other environments.

Current Skills:

• zul-writer: Generates ZK Framework ZUL pages via a structured 4-step workflow.

Repository Structure

agent-skill/
├── marketplace.json      # Storefront index of all skills
├── gemini-extension.json # Gemini CLI extension manifest
├── GEMINI.md             # Gemini CLI guidance file
├── CLAUDE.md             # Claude Code guidance file
├── skills/               # Canonical skill location (real files)
│   └── zul-writer/      
└── .github/skills/       # GitHub Copilot / Cursor skills (symlinked)

Installation

This repository conforms to the Agent Skills specification. You can install the agent skills using the following methods:

Agent Skills CLI

The recommended way is using the universal Agent Skills CLI since it supports almost all AI tools (Gemini CLI, Claude Code, GitHub Copilot/Cursor). See available agents for more details.

npx skills add zkoss-demo/agent-skill

Gemini CLI

The fastest way is to install directly from the repository URL:

gemini extension install https://github.com/zkoss-demo/agent-skill

Development & Testing

• skills/zul-writer/assets/: ZUL and Java templates.
• skills/zul-writer/scripts/: Validation tools.
• zulwriter-showcase/: Gallery of generated UIs.
• test/: Test data for validation scripts.