[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M783V4469P5Z4VNFKCD0Z9YP":3,"skill-same:01M783V4469P5Z4VNFKCD0Z9YP":129},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":13,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":28,"install":29,"resources":42},"01M783V4469P5Z4VNFKCD0Z9YP","maz-ui",null,"Maz-UI v4 - Modern Vue & Nuxt component library with 50+ standalone components, composables, directives, theming, i18n, and SSR support. Use when building Vue\u002FNuxt applications with forms, dialogs, tables, animations, or need responsive design system with dark mode.","aibizmod\u002Faibizmod-service-web","aibizmod","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F295315630?v=4","01M7836CB8EQY701YQ7N88M591","01M7836CBVPZGNSJ8BRP2BT398",0,"MIT","https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: maz-ui\ndescription: Maz-UI v4 - Modern Vue & Nuxt component library with 50+ standalone components, composables, directives, theming, i18n, and SSR support. Use when building Vue\u002FNuxt applications with forms, dialogs, tables, animations, or need responsive design system with dark mode.\nlicense: MIT\n---\n\n# Maz-UI v4 - Vue & Nuxt Component Library\n\nMaz-UI is a comprehensive, standalone component library for Vue 3 and Nuxt 3 applications, offering 50+ production-ready components, powerful theming, internationalization, and exceptional developer experience.\n\n**Latest Version**: 4.3.3 (as of 2025-12-29)\n**Package**: `maz-ui` | `@maz-ui\u002Fnuxt` | `@maz-ui\u002Fthemes` | `@maz-ui\u002Ftranslations` | `@maz-ui\u002Ficons`\n\n## Quick Start\n\n### Vue 3 Installation\n\n```bash\n# Install core packages\npnpm add maz-ui @maz-ui\u002Fthemes\n\n# Or with npm\nnpm install maz-ui @maz-ui\u002Fthemes\n```\n\n**Setup** in `main.ts`:\n\n```typescript\nimport { createApp } from 'vue'\nimport { MazUi } from 'maz-ui\u002Fplugins\u002Fmaz-ui'\nimport { mazUi } from '@maz-ui\u002Fthemes'\nimport { en } from '@maz-ui\u002Ftranslations'\nimport 'maz-ui\u002Fstyles'\nimport App from '.\u002FApp.vue'\n\nconst app = createApp(App)\n\napp.use(MazUi, {\n  theme: { preset: mazUi },\n  translations: { messages: { en } }\n})\n\napp.mount('#app')\n```\n\n**Use Components**:\n\n```vue\n\u003Cscript setup>\nimport MazBtn from 'maz-ui\u002Fcomponents\u002FMazBtn'\nimport MazInput from 'maz-ui\u002Fcomponents\u002FMazInput'\nimport { ref } from 'vue'\n\nconst inputValue = ref('')\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003CMazInput v-model=\"inputValue\" label=\"Name\" \u002F>\n  \u003CMazBtn color=\"primary\">Submit\u003C\u002FMazBtn>\n\u003C\u002Ftemplate>\n```\n\n###  Nuxt 3 Installation\n\n```bash\n# Install Nuxt module\npnpm add @maz-ui\u002Fnuxt\n```\n\n**Setup** in `nuxt.config.ts`:\n\n```typescript\nexport default defineNuxtConfig({\n  modules: ['@maz-ui\u002Fnuxt']\n  \u002F\u002F That's it! Auto-imports enabled 🎉\n})\n```\n\n**Use Components** (no imports needed):\n\n```vue\n\u003Cscript setup>\n\u002F\u002F Auto-imported composables\nconst theme = useTheme()\nconst toast = useToast()\nconst inputValue = ref('')\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003C!-- Auto-imported components -->\n  \u003CMazInput v-model=\"inputValue\" label=\"Name\" \u002F>\n  \u003CMazBtn color=\"primary\" @click=\"toast.success('Submitted!')\">\n    Submit\n  \u003C\u002FMazBtn>\n\u003C\u002Ftemplate>\n```\n\n## Core Capabilities\n\n### 🎨 Components (50+)\n\n**Forms & Inputs**:\n- `MazInput` - Text input with validation states\n- `MazSelect` - Dropdown select\n- `MazTextarea` - Multi-line text input\n- `MazCheckbox` - Checkbox with label\n- `MazRadio` - Radio buttons\n- `MazSwitch` - Toggle switch\n- `MazSlider` - Range slider\n- `MazInputPhoneNumber` - International phone input with validation\n- `MazInputCode` - Code\u002FPIN input\n- `MazInputPrice` - Currency input with formatting\n- `MazInputTags` - Tag\u002Fchip input\n- `MazDatePicker` - Date picker\n- `MazChecklist` - Searchable checklist\n\n**UI Elements**:\n- `MazBtn` - Button with variants\n- `MazCard` - Container card\n- `MazBadge` - Label badge\n- `MazAvatar` - User avatar\n- `MazIcon` - Icon display\n- `MazSpinner` - Loading spinner\n- `MazTable` - Data table with sorting\u002Fpagination\n- `MazTabs` - Tab navigation\n- `MazStepper` - Step indicator\n- `MazPagination` - Pagination controls\n\n**Overlays & Modals**:\n- `MazDialog` - Modal dialog\n- `MazDialogConfirm` - Confirmation dialog\n- `MazDrawer` - Slide-out drawer\n- `MazBottomSheet` - Mobile bottom sheet\n- `MazBackdrop` - Overlay backdrop\n- `MazPopover` - Floating popover\n- `MazDropdown` - Dropdown menu\n\n**Feedback & Animation**:\n- `MazFullscreenLoader` - Loading overlay\n- `MazLoadingBar` - Progress bar\n- `MazCircularProgressBar` - Circular progress\n- `MazReadingProgressBar` - Reading progress indicator\n- `MazAnimatedText` - Text animations\n- `MazAnimatedElement` - Element animations\n- `MazAnimatedCounter` - Number counter animation\n- `MazCardSpotlight` - Card with spotlight effect\n\n**Layout & Display**:\n- `MazCarousel` - Image carousel\n- `MazGallery` - Image gallery\n- `MazAccordion` - Collapsible panels\n- `MazExpandAnimation` - Expand\u002Fcollapse animation\n- `MazLazyImg` - Lazy-loaded image\n- `MazPullToRefresh` - Pull-to-refresh gesture\n- `MazChart` - Chart.js integration\n\n### 🔧 Composables (14+)\n\n**Theming**:\n- `useTheme()` - Theme and dark mode management\n\n**Translations**:\n- `useTranslations()` - i18n management\n\n**UI Interactions**:\n- `useToast()` - Toast notifications\n- `useDialog()` - Programmatic dialogs\n- `useWait()` - Loading states\n\n**Utilities**:\n- `useBreakpoints()` - Responsive breakpoints\n- `useWindowSize()` - Window dimensions\n- `useTimer()` - Timer\u002Fcountdown\n- `useFormValidator()` - Form validation (Valibot)\n- `useIdleTimeout()` - Idle detection\n- `useUserVisibility()` - Page visibility\n- `useSwipe()` - Swipe gestures\n- `useReadingTime()` - Reading time calculation\n- `useStringMatching()` - String utilities\n- `useDisplayNames()` - Localized display names\n\n### 📌 Directives (5)\n\n- `v-tooltip` - Tooltips\n- `v-click-outside` - Outside click detection\n- `v-lazy-img` - Lazy loading\n- `v-zoom-img` - Image zoom\n- `v-fullscreen-img` - Fullscreen image viewer\n\n### 🔌 Plugins (4)\n\n- **AOS** - Animations on scroll\n- **Dialog** - Template-free dialogs\n- **Toast** - Notifications\n- **Wait** - Global loading states\n\n## Key Features\n\n✅ **Standalone Components** - Import only what you need, zero bloat\n✅ **SSR\u002FSSG Ready** - Full Nuxt 3 support with auto-imports\n✅ **TypeScript-First** - Complete type safety out of the box\n✅ **Dark Mode** - Built-in dark\u002Flight theme switching\n✅ **Tree-Shakable** - Optimized bundle sizes\n✅ **Responsive** - Mobile-first design\n✅ **Accessible** - ARIA-compliant components\n✅ **Themeable** - 4 built-in presets + custom themes\n✅ **i18n** - Multi-language support with @maz-ui\u002Ftranslations\n✅ **840+ Icons** - Optimized SVG icon library (@maz-ui\u002Ficons)\n\n## Template Structure\n\nMaz-UI provides **two sets of production-ready templates** organized by framework:\n\n### Vue 3 + Vite Templates (`templates\u002Fvue\u002F`)\n- ✅ Pure Vue 3 with Vite\n- ✅ Uses standard `fetch()` API\n- ✅ Explicit imports for all dependencies\n- ✅ No framework-specific dependencies\n- ✅ Optimized for SPA development\n\n**Use when**: Building Vue 3 applications with Vite\n\n**Available templates**:\n- `setup\u002Fvite.config.ts` - Vite configuration with auto-imports\n- `components\u002Fform-basic.vue` - Basic form validation\n- `components\u002Fform-multi-step.vue` - Multi-step form with stepper\n- `components\u002Fdialog-confirm.vue` - Dialog confirmation patterns\n- `components\u002Fdata-table.vue` - Data table with pagination, search, sort\n\n### Nuxt 3 Templates (`templates\u002Fnuxt\u002F`)\n- ✅ Nuxt 3 optimized\n- ✅ Uses `$fetch` (Nuxt's ofetch wrapper)\n- ✅ Leverages auto-imports for components and composables\n- ✅ Showcases SSR patterns and server routes\n- ✅ Optimized for full-stack Nuxt development\n\n**Use when**: Building Nuxt 3 applications\n\n**Available templates**:\n- `setup\u002Fnuxt.config.ts` - Nuxt configuration with Maz-UI module\n- `components\u002Fform-basic.vue` - Basic form validation (auto-imports)\n- `components\u002Fform-multi-step.vue` - Multi-step form (auto-imports)\n- `components\u002Fdialog-confirm.vue` - Dialog patterns (auto-imports)\n- `components\u002Fdata-table.vue` - Data table with reactive data loading\n\nBoth template sets:\n- ✅ Fix all validation, type inference, and pagination issues\n- ✅ Follow framework best practices\n- ✅ Are production-ready and fully tested\n- ✅ Include setup configs and component examples\n\n## When to Load References\n\nLoad reference files based on what you're implementing. All 21 reference files are grouped by purpose for quick discovery:\n\n### Components (4 files)\n- **`components-forms.md`** - Building forms, inputs, validation, phone numbers, dates, file uploads, MazInput, MazSelect, MazCheckbox, MazDatePicker\n- **`components-feedback.md`** - Adding loaders, progress bars, animations, toasts, MazFullscreenLoader, MazCircularProgressBar, MazAnimatedText, MazCardSpotlight\n- **`components-navigation.md`** - Implementing tabs, steppers, pagination, MazTabs, MazStepper, MazPagination\n- **`components-layout.md`** - Working with cards, drawers, carousels, galleries, MazCard, MazAccordion, MazDrawer, MazCarousel, MazGallery\n\n### Setup & Configuration (2 files)\n- **`setup-vue.md`** - Setting up Maz-UI in Vue 3 project, auto-imports with resolvers, Vite\u002FWebpack configuration, performance optimization\n- **`setup-nuxt.md`** - Integrating with Nuxt 3, module configuration, theme strategies (hybrid\u002Fbuildtime\u002Fruntime), SSR\u002FSSG considerations\n\n### Core Features (5 files)\n- **`composables.md`** - Using all 14 composables: useToast, useTheme, useBreakpoints, useFormValidator, useTimer, useDialog, useTranslations, etc.\n- **`directives.md`** - Adding directives: v-tooltip, v-click-outside, v-lazy-img, v-zoom-img, v-fullscreen-img\n- **`plugins.md`** - Enabling plugins: AOS (animations on scroll), Dialog, Toast, Wait (loading states)\n- **`resolvers.md`** - **CRITICAL**: Auto-import configuration with MazComponentsResolver, MazDirectivesResolver, MazModulesResolver for optimal tree-shaking\n- **`translations.md`** - Implementing multi-language support (8 built-in languages), custom locales, lazy loading, SSR hydration\n\n### Tools & Integrations (3 files)\n- **`icons.md`** - Using @maz-ui\u002Ficons package (840+ icons), MazIcon component, icon sizing, colors, animations\n- **`cli.md`** - Using @maz-ui\u002Fcli (legacy v3), theme configuration, migration to v4 themes system\n- **`mcp.md`** - Setting up Model Context Protocol server for AI assistant integration (Claude Code, Claude Desktop, Cursor, Windsurf)\n\n### Advanced Topics (5 files)\n- **`theming.md`** - Customizing themes, dark mode, color schemes, CSS variables, 4 built-in presets (mazUi, ocean, pristine, obsidian)\n- **`performance.md`** - Bundle optimization, tree-shaking, lazy loading, code splitting, reducing bundle size from ~300KB to ~15KB\n- **`ssr-ssg.md`** - **Comprehensive SSR\u002FSSG guide**: theme strategies, critical CSS, hydration prevention, dark mode without flash, static site generation\n- **`accessibility.md`** - WCAG 2.1 AA compliance, keyboard navigation, screen reader support, ARIA attributes, color contrast\n- **`form-validation.md`** - useFormValidator deep dive, Valibot integration, 5 validation modes (lazy, aggressive, eager, blur, progressive), TypeScript type inference\n\n### Troubleshooting (2 files)\n- **`migration-v4.md`** - Upgrading from Maz-UI v3 to v4, breaking changes, API changes, component renames, TypeScript updates\n- **`troubleshooting.md`** - Debugging errors, common issues, configuration problems, SSR hydration, bundle size issues\n\n## Top 6 Common Errors\n\n### 1. Missing Theme Plugin Error\n**Error**: `\"useTheme must be used within MazUi plugin installation\"`\n**Cause**: MazUi plugin not installed or theme composable disabled\n**Fix**:\n```typescript\n\u002F\u002F Vue\napp.use(MazUi, { theme: { preset: mazUi } })\n\n\u002F\u002F Nuxt\nexport default defineNuxtConfig({\n  mazUi: {\n    composables: { useTheme: true },\n    theme: { preset: 'maz-ui' }\n  }\n})\n```\n\n### 2. Auto-Import Not Working (Nuxt)\n**Error**: Components\u002Fcomposables not found despite Nuxt module installed\n**Cause**: Module not properly configured or cache issue\n**Fix**:\n```bash\n# Clear Nuxt cache\nrm -rf .nuxt node_modules\u002F.cache\npnpm install\n```\n**Verify** `nuxt.config.ts`:\n```typescript\nexport default defineNuxtConfig({\n  modules: ['@maz-ui\u002Fnuxt']\n})\n```\n\n### 3. Styles Not Applied\n**Error**: Components render but have no styling\n**Cause**: CSS not imported\n**Fix Vue**:\n```typescript\nimport 'maz-ui\u002Fstyles' \u002F\u002F Add this line\n```\n**Fix Nuxt**:\n```typescript\nexport default defineNuxtConfig({\n  mazUi: {\n    css: { injectMainCss: true } \u002F\u002F Ensure this is true\n  }\n})\n```\n\n### 4. TypeScript Errors with Components\n**Error**: `Cannot find module 'maz-ui\u002Fcomponents\u002FMazBtn'`\n**Cause**: Missing type definitions or incorrect import path\n**Fix**:\n```typescript\n\u002F\u002F Correct import\nimport MazBtn from 'maz-ui\u002Fcomponents\u002FMazBtn'\n\n\u002F\u002F Or with auto-import (Nuxt)\n\u002F\u002F No import needed, just use \u003CMazBtn>\n```\n**Ensure** `tsconfig.json` includes:\n```json\n{\n  \"compilerOptions\": {\n    \"types\": [\"maz-ui\u002Ftypes\"]\n  }\n}\n```\n\n### 5. Phone Input Country Detection Fails\n**Error**: `MazInputPhoneNumber` doesn't detect country or shows wrong flag\n**Cause**: Missing libphonenumber-js dependency or country data not loaded\n**Fix**:\n```bash\n# Install peer dependency\npnpm add libphonenumber-js\n```\n```vue\n\u003CMazInputPhoneNumber\n  v-model=\"phone\"\n  default-country-code=\"US\"\n  preferred-countries=\"['US', 'CA', 'GB']\"\n\u002F>\n```\n\n### 6. Translations Not Loading or Showing Raw Keys\n**Error**: Translation keys showing as raw strings like `inputPhoneNumber.phoneInput.example` instead of translated text\n**Causes**:\n- Missing locale import\n- Lazy loading not awaited properly\n- Language file failed to load asynchronously\n- Missing `preloadFallback` configuration\n- SSR hydration mismatch (Nuxt)\n\n**Fix Vue** (Immediate Loading):\n```typescript\nimport { fr } from '@maz-ui\u002Ftranslations'\n\napp.use(MazUi, {\n  translations: {\n    locale: 'fr',\n    fallbackLocale: 'en',\n    preloadFallback: true,\n    messages: { fr } \u002F\u002F Import immediately\n  }\n})\n```\n\n**Fix Vue** (Lazy Loading):\n```typescript\napp.use(MazUi, {\n  translations: {\n    locale: 'fr',\n    preloadFallback: true, \u002F\u002F Ensure fallback is preloaded\n    messages: {\n      fr: () => import('@maz-ui\u002Ftranslations\u002Flocales\u002Ffr')\n    }\n  }\n})\n\n\u002F\u002F In component: ALWAYS use await\nconst { setLocale } = useTranslations()\nawait setLocale('fr') \u002F\u002F Don't forget await!\n```\n\n**Fix Nuxt** (Avoid Hydration):\n```typescript\nimport { fr } from '@maz-ui\u002Ftranslations'\n\nexport default defineNuxtConfig({\n  mazUi: {\n    translations: {\n      locale: 'fr',\n      preloadFallback: true,\n      messages: {\n        \u002F\u002F CRITICAL: Provide initial locale immediately (not as function)\n        fr, \u002F\u002F SSR requires immediate load\n\n        \u002F\u002F Other languages can be lazy\n        es: () => import('@maz-ui\u002Ftranslations\u002Flocales\u002Fes')\n      }\n    }\n  }\n})\n```\n\n**Error Handling**:\n```vue\n\u003Cscript setup>\nconst { setLocale } = useTranslations()\nconst toast = useToast()\n\nasync function switchLanguage(locale) {\n  try {\n    await setLocale(locale)\n    toast.success(`Language changed to ${locale}`)\n  } catch (error) {\n    console.error('Translation loading error:', error)\n    toast.error('Failed to load translations')\n  }\n}\n\u003C\u002Fscript>\n```\n\n**Learn More**: Load `references\u002Ftranslations.md` for comprehensive i18n setup, lazy loading strategies, and production patterns.\n\n## Tree-Shaking Best Practices\n\n**Direct Imports** (Most Optimized):\n```typescript\n\u002F\u002F ✅✅✅ Best - smallest bundle\nimport MazBtn from 'maz-ui\u002Fcomponents\u002FMazBtn'\nimport { useToast } from 'maz-ui\u002Fcomposables\u002FuseToast'\nimport { vClickOutside } from 'maz-ui\u002Fdirectives\u002FvClickOutside'\n```\n\n**Index Imports** (Good):\n```typescript\n\u002F\u002F ✅ Good - tree-shakable\nimport { MazBtn, MazInput } from 'maz-ui\u002Fcomponents'\nimport { useToast, useTheme } from 'maz-ui\u002Fcomposables'\n```\n\n**Avoid** (Not Tree-Shakable):\n```typescript\n\u002F\u002F ❌ Imports everything\nimport * as MazUI from 'maz-ui'\n```\n\n## Advanced Topics\n\n### Performance Optimization\n\nMaz-UI can be optimized from ~300KB to ~15KB through strategic imports and tree-shaking. Use auto-import resolvers (`MazComponentsResolver`, `MazDirectivesResolver`, `MazModulesResolver`) for optimal bundle size, lazy load components with dynamic imports, and split code by feature. Load **`performance.md`** for comprehensive bundle optimization strategies.\n\n### SSR & SSG\n\nFull server-side rendering and static site generation support with three theme strategies: **hybrid** (critical CSS injection, no FOUC), **buildtime** (smallest bundle, static themes), and **runtime** (full theme switching, larger bundle). Prevent hydration mismatches by wrapping client-only components in `\u003CClientOnly>`. Load **`ssr-ssg.md`** for critical CSS patterns, dark mode without flash, and SSR\u002FSSG checklist.\n\n### Accessibility\n\nAll Maz-UI components are WCAG 2.1 AA compliant with proper ARIA attributes, keyboard navigation, focus management, and screen reader support. Components include semantic HTML, color contrast ratios >4.5:1, and accessible form validation. Load **`accessibility.md`** for keyboard shortcuts, focus trap patterns, and accessibility testing checklist.\n\n### Form Validation\n\nThe `useFormValidator()` composable integrates with Valibot for type-safe schema validation with full TypeScript inference. Supports 5 validation modes (lazy, aggressive, eager, blur, progressive), async validation, custom validators, and real-time error messages. Load **`form-validation.md`** for comprehensive validation patterns and real-world examples.\n\n### Auto-Import Resolvers\n\n**Critical for tree-shaking**: Use `unplugin-vue-components` and `unplugin-auto-import` with Maz-UI resolvers to import only what you use. Reduces bundle size by 60-90% compared to global imports. Configure prefix handling to avoid naming conflicts with other libraries. Load **`resolvers.md`** for complete resolver configuration and troubleshooting.\n\n## Progressive Disclosure Summary\n\nThis SKILL.md provides:\n1. **Quick Start** - Get running in \u003C5 minutes\n2. **Core Capabilities** - Overview of all features\n3. **Error Prevention** - Top 5 common issues solved\n\nFor detailed implementation:\n- Load **reference files** based on your current task (see \"When to Load References\" above)\n- Each reference contains comprehensive guides, code examples, and advanced configurations\n- References are organized by domain (components, setup, theming, etc.) for easy navigation\n\n## Package Ecosystem\n\n- **maz-ui** - Core component library\n- **@maz-ui\u002Fnuxt** - Nuxt 3 module with auto-imports\n- **@maz-ui\u002Fthemes** - Theming system and presets\n- **@maz-ui\u002Ftranslations** - i18n support (8 built-in languages: en, fr, es, de, it, pt, ja, zh-CN)\n- **@maz-ui\u002Ficons** - 840+ optimized SVG icons\n- **@maz-ui\u002Fmcp** - AI agent documentation server\n\n## Official Resources\n\n- **Documentation**: https:\u002F\u002Fmaz-ui.com\n- **GitHub**: https:\u002F\u002Fgithub.com\u002FLouisMazel\u002Fmaz-ui\n- **NPM**: https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fmaz-ui\n- **Discord**: https:\u002F\u002Fdiscord.gg\u002Fmaz-ui\n- **Changelog**: https:\u002F\u002Fgithub.com\u002FLouisMazel\u002Fmaz-ui\u002Fblob\u002Fmaster\u002FCHANGELOG.md\n","# Maz-UI v4 - Vue & Nuxt Component Library\n\nMaz-UI is a comprehensive, standalone component library for Vue 3 and Nuxt 3 applications, offering 50+ production-ready components, powerful theming, internationalization, and exceptional developer experience.\n\n**Latest Version**: 4.3.3 (as of 2025-12-29)\n**Package**: `maz-ui` | `@maz-ui\u002Fnuxt` | `@maz-ui\u002Fthemes` | `@maz-ui\u002Ftranslations` | `@maz-ui\u002Ficons`\n\n## Quick Start\n\n### Vue 3 Installation\n\n```bash\n# Install core packages\npnpm add maz-ui @maz-ui\u002Fthemes\n\n# Or with npm\nnpm install maz-ui @maz-ui\u002Fthemes\n```\n\n**Setup** in `main.ts`:\n\n```typescript\nimport { createApp } from 'vue'\nimport { MazUi } from 'maz-ui\u002Fplugins\u002Fmaz-ui'\nimport { mazUi } from '@maz-ui\u002Fthemes'\nimport { en } from '@maz-ui\u002Ftranslations'\nimport 'maz-ui\u002Fstyles'\nimport App from '.\u002FApp.vue'\n\nconst app = createApp(App)\n\napp.use(MazUi, {\n  theme: { preset: mazUi },\n  translations: { messages: { en } }\n})\n\napp.mount('#app')\n```\n\n**Use Components**:\n\n```vue\n\u003Cscript setup>\nimport MazBtn from 'maz-ui\u002Fcomponents\u002FMazBtn'\nimport MazInput from 'maz-ui\u002Fcomponents\u002FMazInput'\nimport { ref } from 'vue'\n\nconst inputValue = ref('')\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003CMazInput v-model=\"inputValue\" label=\"Name\" \u002F>\n  \u003CMazBtn color=\"primary\">Submit\u003C\u002FMazBtn>\n\u003C\u002Ftemplate>\n```\n\n###  Nuxt 3 Installation\n\n```bash\n# Install Nuxt module\npnpm add @maz-ui\u002Fnuxt\n```\n\n**Setup** in `nuxt.config.ts`:\n\n```typescript\nexport default defineNuxtConfig({\n  modules: ['@maz-ui\u002Fnuxt']\n  \u002F\u002F That's it! Auto-imports enabled 🎉\n})\n```\n\n**Use Components** (no imports needed):\n\n```vue\n\u003Cscript setup>\n\u002F\u002F Auto-imported composables\nconst theme = useTheme()\nconst toast = useToast()\nconst inputValue = ref('')\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003C!-- Auto-imported components -->\n  \u003CMazInput v-model=\"inputValue\" label=\"Name\" \u002F>\n  \u003CMazBtn color=\"primary\" @click=\"toast.success('Submitted!')\">\n    Submit\n  \u003C\u002FMazBtn>\n\u003C\u002Ftemplate>\n```\n\n## Core Capabilities\n\n### 🎨 Components (50+)\n\n**Forms & Inputs**:\n- `MazInput` - Text input with validation states\n- `MazSelect` - Dropdown select\n- `MazTextarea` - Multi-line text input\n- `MazCheckbox` - Checkbox with label\n- `MazRadio` - Radio buttons\n- `MazSwitch` - Toggle switch\n- `MazSlider` - Range slider\n- `MazInputPhoneNumber` - International phone input with validation\n- `MazInputCode` - Code\u002FPIN input\n- `MazInputPrice` - Currency input with formatting\n- `MazInputTags` - Tag\u002Fchip input\n- `MazDatePicker` - Date picker\n- `MazChecklist` - Searchable checklist\n\n**UI Elements**:\n- `MazBtn` - Button with variants\n- `MazCard` - Container card\n- `MazBadge` - Label badge\n- `MazAvatar` - User avatar\n- `MazIcon` - Icon display\n- `MazSpinner` - Loading spinner\n- `MazTable` - Data table with sorting\u002Fpagination\n- `MazTabs` - Tab navigation\n- `MazStepper` - Step indicator\n- `MazPagination` - Pagination controls\n\n**Overlays & Modals**:\n- `MazDialog` - Modal dialog\n- `MazDialogConfirm` - Confirmation dialog\n- `MazDrawer` - Slide-out drawer\n- `MazBottomSheet` - Mobile bottom sheet\n- `MazBackdrop` - Overlay backdrop\n- `MazPopover` - Floating popover\n- `MazDropdown` - Dropdown menu\n\n**Feedback & Animation**:\n- `MazFullscreenLoader` - Loading overlay\n- `MazLoadingBar` - Progress bar\n- `MazCircularProgressBar` - Circular progress\n- `MazReadingProgressBar` - Reading progress indicator\n- `MazAnimatedText` - Text animations\n- `MazAnimatedElement` - Element animations\n- `MazAnimatedCounter` - Number counter animation\n- `MazCardSpotlight` - Card with spotlight effect\n\n**Layout & Display**:\n- `MazCarousel` - Image carousel\n- `MazGallery` - Image gallery\n- `MazAccordion` - Collapsible panels\n- `MazExpandAnimation` - Expand\u002Fcollapse animation\n- `MazLazyImg` - Lazy-loaded image\n- `MazPullToRefresh` - Pull-to-refresh gesture\n- `MazChart` - Chart.js integration\n\n### 🔧 Composables (14+)\n\n**Theming**:\n- `useTheme()` - Theme and dark mode management\n\n**Translations**:\n- `useTranslations()` - i18n management\n\n**UI Interactions**:\n- `useToast()` - Toast notifications\n- `useDialog()` - Programmatic dialogs\n- `useWait()` - Loading states\n\n**Utilities**:\n- `useBreakpoints()` - Responsive breakpoints\n- `useWindowSize()` - Window dimensions\n- `useTimer()` - Timer\u002Fcountdown\n- `useFormValidator()` - Form validation (Valibot)\n- `useIdleTimeout()` - Idle detection\n- `useUserVisibility()` - Page visibility\n- `useSwipe()` - Swipe gestures\n- `useReadingTime()` - Reading time calculation\n- `useStringMatching()` - String utilities\n- `useDisplayNames()` - Localized display names\n\n### 📌 Directives (5)\n\n- `v-tooltip` - Tooltips\n- `v-click-outside` - Outside click detection\n- `v-lazy-img` - Lazy loading\n- `v-zoom-img` - Image zoom\n- `v-fullscreen-img` - Fullscreen image viewer\n\n### 🔌 Plugins (4)\n\n- **AOS** - Animations on scroll\n- **Dialog** - Template-free dialogs\n- **Toast** - Notifications\n- **Wait** - Global loading states\n\n## Key Features\n\n✅ **Standalone Components** - Import only what you need, zero bloat\n✅ **SSR\u002FSSG Ready** - Full Nuxt 3 support with auto-imports\n✅ **TypeScript-First** - Complete type safety out of the box\n✅ **Dark Mode** - Built-in dark\u002Flight theme switching\n✅ **Tree-Shakable** - Optimized bundle sizes\n✅ **Responsive** - Mobile-first design\n✅ **Accessible** - ARIA-compliant components\n✅ **Themeable** - 4 built-in presets + custom themes\n✅ **i18n** - Multi-language support with @maz-ui\u002Ftranslations\n✅ **840+ Icons** - Optimized SVG icon library (@maz-ui\u002Ficons)\n\n## Template Structure\n\nMaz-UI provides **two sets of production-ready templates** organized by framework:\n\n### Vue 3 + Vite Templates (`templates\u002Fvue\u002F`)\n- ✅ Pure Vue 3 with Vite\n- ✅ Uses standard `fetch()` API\n- ✅ Explicit imports for all dependencies\n- ✅ No framework-specific dependencies\n- ✅ Optimized for SPA development\n\n**Use when**: Building Vue 3 applications with Vite\n\n**Available templates**:\n- `setup\u002Fvite.config.ts` - Vite configuration with auto-imports\n- `components\u002Fform-basic.vue` - Basic form validation\n- `components\u002Fform-multi-step.vue` - Multi-step form with stepper\n- `components\u002Fdialog-confirm.vue` - Dialog confirmation patterns\n- `components\u002Fdata-table.vue` - Data table with pagination, search, sort\n\n### Nuxt 3 Templates (`templates\u002Fnuxt\u002F`)\n- ✅ Nuxt 3 optimized\n- ✅ Uses `$fetch` (Nuxt's ofetch wrapper)\n- ✅ Leverages auto-imports for components and composables\n- ✅ Showcases SSR patterns and server routes\n- ✅ Optimized for full-stack Nuxt development\n\n**Use when**: Building Nuxt 3 applications\n\n**Available templates**:\n- `setup\u002Fnuxt.config.ts` - Nuxt configuration with Maz-UI module\n- `components\u002Fform-basic.vue` - Basic form validation (auto-imports)\n- `components\u002Fform-multi-step.vue` - Multi-step form (auto-imports)\n- `components\u002Fdialog-confirm.vue` - Dialog patterns (auto-imports)\n- `components\u002Fdata-table.vue` - Data table with reactive data loading\n\nBoth template sets:\n- ✅ Fix all validation, type inference, and pagination issues\n- ✅ Follow framework best practices\n- ✅ Are production-ready and fully tested\n- ✅ Include setup configs and component examples\n\n## When to Load References\n\nLoad reference files based on what you're implementing. All 21 reference files are grouped by purpose for quick discovery:\n\n### Components (4 files)\n- **`components-forms.md`** - Building forms, inputs, validation, phone numbers, dates, file uploads, MazInput, MazSelect, MazCheckbox, MazDatePicker\n- **`components-feedback.md`** - Adding loaders, progress bars, animations, toasts, MazFullscreenLoader, MazCircularProgressBar, MazAnimatedText, MazCardSpotlight\n- **`components-navigation.md`** - Implementing tabs, steppers, pagination, MazTabs, MazStepper, MazPagination\n- **`components-layout.md`** - Working with cards, drawers, carousels, galleries, MazCard, MazAccordion, MazDrawer, MazCarousel, MazGallery\n\n### Setup & Configuration (2 files)\n- **`setup-vue.md`** - Setting up Maz-UI in Vue 3 project, auto-imports with resolvers, Vite\u002FWebpack configuration, performance optimization\n- **`setup-nuxt.md`** - Integrating with Nuxt 3, module configuration, theme strategies (hybrid\u002Fbuildtime\u002Fruntime), SSR\u002FSSG considerations\n\n### Core Features (5 files)\n- **`composables.md`** - Using all 14 composables: useToast, useTheme, useBreakpoints, useFormValidator, useTimer, useDialog, useTranslations, etc.\n- **`directives.md`** - Adding directives: v-tooltip, v-click-outside, v-lazy-img, v-zoom-img, v-fullscreen-img\n- **`plugins.md`** - Enabling plugins: AOS (animations on scroll), Dialog, Toast, Wait (loading states)\n- **`resolvers.md`** - **CRITICAL**: Auto-import configuration with MazComponentsResolver, MazDirectivesResolver, MazModulesResolver for optimal tree-shaking\n- **`translations.md`** - Implementing multi-language support (8 built-in languages), custom locales, lazy loading, SSR hydration\n\n### Tools & Integrations (3 files)\n- **`icons.md`** - Using @maz-ui\u002Ficons package (840+ icons), MazIcon component, icon sizing, colors, animations\n- **`cli.md`** - Using @maz-ui\u002Fcli (legacy v3), theme configuration, migration to v4 themes system\n- **`mcp.md`** - Setting up Model Context Protocol server for AI assistant integration (Claude Code, Claude Desktop, Cursor, Windsurf)\n\n### Advanced Topics (5 files)\n- **`theming.md`** - Customizing themes, dark mode, color schemes, CSS variables, 4 built-in presets (mazUi, ocean, pristine, obsidian)\n- **`performance.md`** - Bundle optimization, tree-shaking, lazy loading, code splitting, reducing bundle size from ~300KB to ~15KB\n- **`ssr-ssg.md`** - **Comprehensive SSR\u002FSSG guide**: theme strategies, critical CSS, hydration prevention, dark mode without flash, static site generation\n- **`accessibility.md`** - WCAG 2.1 AA compliance, keyboard navigation, screen reader support, ARIA attributes, color contrast\n- **`form-validation.md`** - useFormValidator deep dive, Valibot integration, 5 validation modes (lazy, aggressive, eager, blur, progressive), TypeScript type inference\n\n### Troubleshooting (2 files)\n- **`migration-v4.md`** - Upgrading from Maz-UI v3 to v4, breaking changes, API changes, component renames, TypeScript updates\n- **`troubleshooting.md`** - Debugging errors, common issues, configuration problems, SSR hydration, bundle size issues\n\n## Top 6 Common Errors\n\n### 1. Missing Theme Plugin Error\n**Error**: `\"useTheme must be used within MazUi plugin installation\"`\n**Cause**: MazUi plugin not installed or theme composable disabled\n**Fix**:\n```typescript\n\u002F\u002F Vue\napp.use(MazUi, { theme: { preset: mazUi } })\n\n\u002F\u002F Nuxt\nexport default defineNuxtConfig({\n  mazUi: {\n    composables: { useTheme: true },\n    theme: { preset: 'maz-ui' }\n  }\n})\n```\n\n### 2. Auto-Import Not Working (Nuxt)\n**Error**: Components\u002Fcomposables not found despite Nuxt module installed\n**Cause**: Module not properly configured or cache issue\n**Fix**:\n```bash\n# Clear Nuxt cache\nrm -rf .nuxt node_modules\u002F.cache\npnpm install\n```\n**Verify** `nuxt.config.ts`:\n```typescript\nexport default defineNuxtConfig({\n  modules: ['@maz-ui\u002Fnuxt']\n})\n```\n\n### 3. Styles Not Applied\n**Error**: Components render but have no styling\n**Cause**: CSS not imported\n**Fix Vue**:\n```typescript\nimport 'maz-ui\u002Fstyles' \u002F\u002F Add this line\n```\n**Fix Nuxt**:\n```typescript\nexport default defineNuxtConfig({\n  mazUi: {\n    css: { injectMainCss: true } \u002F\u002F Ensure this is true\n  }\n})\n```\n\n### 4. TypeScript Errors with Components\n**Error**: `Cannot find module 'maz-ui\u002Fcomponents\u002FMazBtn'`\n**Cause**: Missing type definitions or incorrect import path\n**Fix**:\n```typescript\n\u002F\u002F Correct import\nimport MazBtn from 'maz-ui\u002Fcomponents\u002FMazBtn'\n\n\u002F\u002F Or with auto-import (Nuxt)\n\u002F\u002F No import needed, just use \u003CMazBtn>\n```\n**Ensure** `tsconfig.json` includes:\n```json\n{\n  \"compilerOptions\": {\n    \"types\": [\"maz-ui\u002Ftypes\"]\n  }\n}\n```\n\n### 5. Phone Input Country Detection Fails\n**Error**: `MazInputPhoneNumber` doesn't detect country or shows wrong flag\n**Cause**: Missing libphonenumber-js dependency or country data not loaded\n**Fix**:\n```bash\n# Install peer dependency\npnpm add libphonenumber-js\n```\n```vue\n\u003CMazInputPhoneNumber\n  v-model=\"phone\"\n  default-country-code=\"US\"\n  preferred-countries=\"['US', 'CA', 'GB']\"\n\u002F>\n```\n\n### 6. Translations Not Loading or Showing Raw Keys\n**Error**: Translation keys showing as raw strings like `inputPhoneNumber.phoneInput.example` instead of translated text\n**Causes**:\n- Missing locale import\n- Lazy loading not awaited properly\n- Language file failed to load asynchronously\n- Missing `preloadFallback` configuration\n- SSR hydration mismatch (Nuxt)\n\n**Fix Vue** (Immediate Loading):\n```typescript\nimport { fr } from '@maz-ui\u002Ftranslations'\n\napp.use(MazUi, {\n  translations: {\n    locale: 'fr',\n    fallbackLocale: 'en',\n    preloadFallback: true,\n    messages: { fr } \u002F\u002F Import immediately\n  }\n})\n```\n\n**Fix Vue** (Lazy Loading):\n```typescript\napp.use(MazUi, {\n  translations: {\n    locale: 'fr',\n    preloadFallback: true, \u002F\u002F Ensure fallback is preloaded\n    messages: {\n      fr: () => import('@maz-ui\u002Ftranslations\u002Flocales\u002Ffr')\n    }\n  }\n})\n\n\u002F\u002F In component: ALWAYS use await\nconst { setLocale } = useTranslations()\nawait setLocale('fr') \u002F\u002F Don't forget await!\n```\n\n**Fix Nuxt** (Avoid Hydration):\n```typescript\nimport { fr } from '@maz-ui\u002Ftranslations'\n\nexport default defineNuxtConfig({\n  mazUi: {\n    translations: {\n      locale: 'fr',\n      preloadFallback: true,\n      messages: {\n        \u002F\u002F CRITICAL: Provide initial locale immediately (not as function)\n        fr, \u002F\u002F SSR requires immediate load\n\n        \u002F\u002F Other languages can be lazy\n        es: () => import('@maz-ui\u002Ftranslations\u002Flocales\u002Fes')\n      }\n    }\n  }\n})\n```\n\n**Error Handling**:\n```vue\n\u003Cscript setup>\nconst { setLocale } = useTranslations()\nconst toast = useToast()\n\nasync function switchLanguage(locale) {\n  try {\n    await setLocale(locale)\n    toast.success(`Language changed to ${locale}`)\n  } catch (error) {\n    console.error('Translation loading error:', error)\n    toast.error('Failed to load translations')\n  }\n}\n\u003C\u002Fscript>\n```\n\n**Learn More**: Load `references\u002Ftranslations.md` for comprehensive i18n setup, lazy loading strategies, and production patterns.\n\n## Tree-Shaking Best Practices\n\n**Direct Imports** (Most Optimized):\n```typescript\n\u002F\u002F ✅✅✅ Best - smallest bundle\nimport MazBtn from 'maz-ui\u002Fcomponents\u002FMazBtn'\nimport { useToast } from 'maz-ui\u002Fcomposables\u002FuseToast'\nimport { vClickOutside } from 'maz-ui\u002Fdirectives\u002FvClickOutside'\n```\n\n**Index Imports** (Good):\n```typescript\n\u002F\u002F ✅ Good - tree-shakable\nimport { MazBtn, MazInput } from 'maz-ui\u002Fcomponents'\nimport { useToast, useTheme } from 'maz-ui\u002Fcomposables'\n```\n\n**Avoid** (Not Tree-Shakable):\n```typescript\n\u002F\u002F ❌ Imports everything\nimport * as MazUI from 'maz-ui'\n```\n\n## Advanced Topics\n\n### Performance Optimization\n\nMaz-UI can be optimized from ~300KB to ~15KB through strategic imports and tree-shaking. Use auto-import resolvers (`MazComponentsResolver`, `MazDirectivesResolver`, `MazModulesResolver`) for optimal bundle size, lazy load components with dynamic imports, and split code by feature. Load **`performance.md`** for comprehensive bundle optimization strategies.\n\n### SSR & SSG\n\nFull server-side rendering and static site generation support with three theme strategies: **hybrid** (critical CSS injection, no FOUC), **buildtime** (smallest bundle, static themes), and **runtime** (full theme switching, larger bundle). Prevent hydration mismatches by wrapping client-only components in `\u003CClientOnly>`. Load **`ssr-ssg.md`** for critical CSS patterns, dark mode without flash, and SSR\u002FSSG checklist.\n\n### Accessibility\n\nAll Maz-UI components are WCAG 2.1 AA compliant with proper ARIA attributes, keyboard navigation, focus management, and screen reader support. Components include semantic HTML, color contrast ratios >4.5:1, and accessible form validation. Load **`accessibility.md`** for keyboard shortcuts, focus trap patterns, and accessibility testing checklist.\n\n### Form Validation\n\nThe `useFormValidator()` composable integrates with Valibot for type-safe schema validation with full TypeScript inference. Supports 5 validation modes (lazy, aggressive, eager, blur, progressive), async validation, custom validators, and real-time error messages. Load **`form-validation.md`** for comprehensive validation patterns and real-world examples.\n\n### Auto-Import Resolvers\n\n**Critical for tree-shaking**: Use `unplugin-vue-components` and `unplugin-auto-import` with Maz-UI resolvers to import only what you use. Reduces bundle size by 60-90% compared to global imports. Configure prefix handling to avoid naming conflicts with other libraries. Load **`resolvers.md`** for complete resolver configuration and troubleshooting.\n\n## Progressive Disclosure Summary\n\nThis SKILL.md provides:\n1. **Quick Start** - Get running in \u003C5 minutes\n2. **Core Capabilities** - Overview of all features\n3. **Error Prevention** - Top 5 common issues solved\n\nFor detailed implementation:\n- Load **reference files** based on your current task (see \"When to Load References\" above)\n- Each reference contains comprehensive guides, code examples, and advanced configurations\n- References are organized by domain (components, setup, theming, etc.) for easy navigation\n\n## Package Ecosystem\n\n- **maz-ui** - Core component library\n- **@maz-ui\u002Fnuxt** - Nuxt 3 module with auto-imports\n- **@maz-ui\u002Fthemes** - Theming system and presets\n- **@maz-ui\u002Ftranslations** - i18n support (8 built-in languages: en, fr, es, de, it, pt, ja, zh-CN)\n- **@maz-ui\u002Ficons** - 840+ optimized SVG icons\n- **@maz-ui\u002Fmcp** - AI agent documentation server\n\n## Official Resources\n\n- **Documentation**: https:\u002F\u002Fmaz-ui.com\n- **GitHub**: https:\u002F\u002Fgithub.com\u002FLouisMazel\u002Fmaz-ui\n- **NPM**: https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fmaz-ui\n- **Discord**: https:\u002F\u002Fdiscord.gg\u002Fmaz-ui\n- **Changelog**: https:\u002F\u002Fgithub.com\u002FLouisMazel\u002Fmaz-ui\u002Fblob\u002Fmaster\u002FCHANGELOG.md\n",{"name":5,"license":14,"description":7},"main","9f54582c8b485462d402d7e70feaef34801746b9",".opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui","https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web","https:\u002F\u002Fgithub.com\u002Faibizmod","2026-09-24 00:48:11",{"source":8,"skillName":5,"commands":30,"prompt":40,"zipAvailable":41},[31,34,37],{"tool":32,"command":33},"npx","npx skills add aibizmod\u002Faibizmod-service-web --skill maz-ui",{"tool":35,"command":36},"bunx","bunx skills add aibizmod\u002Faibizmod-service-web --skill maz-ui",{"tool":38,"command":39},"pnpm","pnpm dlx skills add aibizmod\u002Faibizmod-service-web --skill maz-ui","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002FSKILL.md",true,[43,49,53,57,61,65,69,73,77,81,85,89,93,97,101,105,109,113,117,121,125],{"path":44,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":47,"sourceHtmlUrl":48},"references\u002Faccessibility.md","REFERENCE","参考文档",16587,"https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002Freferences\u002Faccessibility.md",{"path":50,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":51,"sourceHtmlUrl":52},"references\u002Fcli.md",11048,"https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002Freferences\u002Fcli.md",{"path":54,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":55,"sourceHtmlUrl":56},"references\u002Fcomponents-feedback.md",19565,"https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002Freferences\u002Fcomponents-feedback.md",{"path":58,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":59,"sourceHtmlUrl":60},"references\u002Fcomponents-forms.md",8556,"https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002Freferences\u002Fcomponents-forms.md",{"path":62,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":63,"sourceHtmlUrl":64},"references\u002Fcomponents-layout.md",18209,"https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002Freferences\u002Fcomponents-layout.md",{"path":66,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":67,"sourceHtmlUrl":68},"references\u002Fcomponents-navigation.md",19923,"https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002Freferences\u002Fcomponents-navigation.md",{"path":70,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":71,"sourceHtmlUrl":72},"references\u002Fcomposables.md",28942,"https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002Freferences\u002Fcomposables.md",{"path":74,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":75,"sourceHtmlUrl":76},"references\u002Fdirectives.md",17365,"https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002Freferences\u002Fdirectives.md",{"path":78,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":79,"sourceHtmlUrl":80},"references\u002Fform-validation.md",23210,"https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002Freferences\u002Fform-validation.md",{"path":82,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":83,"sourceHtmlUrl":84},"references\u002Ficons.md",15279,"https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002Freferences\u002Ficons.md",{"path":86,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":87,"sourceHtmlUrl":88},"references\u002Fmcp.md",13904,"https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002Freferences\u002Fmcp.md",{"path":90,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":91,"sourceHtmlUrl":92},"references\u002Fmigration-v4.md",21542,"https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002Freferences\u002Fmigration-v4.md",{"path":94,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":95,"sourceHtmlUrl":96},"references\u002Fperformance.md",17366,"https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002Freferences\u002Fperformance.md",{"path":98,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":99,"sourceHtmlUrl":100},"references\u002Fplugins.md",25740,"https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002Freferences\u002Fplugins.md",{"path":102,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":103,"sourceHtmlUrl":104},"references\u002Fresolvers.md",26814,"https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002Freferences\u002Fresolvers.md",{"path":106,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":107,"sourceHtmlUrl":108},"references\u002Fsetup-nuxt.md",26580,"https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002Freferences\u002Fsetup-nuxt.md",{"path":110,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":111,"sourceHtmlUrl":112},"references\u002Fsetup-vue.md",22263,"https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002Freferences\u002Fsetup-vue.md",{"path":114,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":115,"sourceHtmlUrl":116},"references\u002Fssr-ssg.md",14197,"https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002Freferences\u002Fssr-ssg.md",{"path":118,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":119,"sourceHtmlUrl":120},"references\u002Ftheming.md",7345,"https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002Freferences\u002Ftheming.md",{"path":122,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":123,"sourceHtmlUrl":124},"references\u002Ftranslations.md",20564,"https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002Freferences\u002Ftranslations.md",{"path":126,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":127,"sourceHtmlUrl":128},"references\u002Ftroubleshooting.md",9169,"https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fmaz-ui\u002Fskills\u002Fmaz-ui\u002Freferences\u002Ftroubleshooting.md",[130,137,144,151,158,165],{"skillNo":131,"name":132,"nameZh":6,"description":133,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":134,"categories":135,"keywords":136,"publishedAt":18},"01M7846EAPZWCQ8C6G3AAMMR57","{TODO=lowercase-hyphen-case-name}","[TODO: Write comprehensive description in third-person. Start with \"This skill provides...\" or \"This skill should be used when...\"]\n\n[TODO: Add \"Use when\" scenarios - specific situations where Claude should use this skill]\n\n[TODO: Add keywords - technologies, use cases, error messages that should trigger this skill]","https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Ftemplates\u002Fskill-skeleton\u002Fskills\u002Fskill-name\u002FSKILL.md",[],[],{"skillNo":138,"name":139,"nameZh":6,"description":140,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":141,"categories":142,"keywords":143,"publishedAt":18},"01M7846A0WGDKJTDPD5QMHQVFV","zustand-state-management","Zustand state management for React with TypeScript. Use for global state, Redux\u002FContext API migration, localStorage persistence, slices pattern, devtools, Next.js SSR, or encountering hydration errors, TypeScript inference issues, persist middleware problems, infinite render loops.","https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fzustand-state-management\u002Fskills\u002Fzustand-state-management\u002FSKILL.md",[],[],{"skillNo":145,"name":146,"nameZh":6,"description":147,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":148,"categories":149,"keywords":150,"publishedAt":18},"01M78463GGSP9B3JSF146B2MG0","zod","TypeScript-first schema validation and type inference. Use for validating API requests\u002Fresponses, form data, env vars, configs, defining type-safe schemas with runtime validation, transforming data, generating JSON Schema for OpenAPI\u002FAI, or encountering missing validation errors, type inference issues, validation error handling problems. Zero dependencies (2kb gzipped).","https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fzod\u002Fskills\u002Fzod\u002FSKILL.md",[],[],{"skillNo":152,"name":153,"nameZh":6,"description":154,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":155,"categories":156,"keywords":157,"publishedAt":18},"01M7845ZX17SVNNY7EDGPJHSBT","xss-prevention","XSS attack prevention with input sanitization, output encoding, Content Security Policy. Use for user-generated content, rich text editors, web application security, or encountering stored XSS, reflected XSS, DOM manipulation, script injection errors.","https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fxss-prevention\u002Fskills\u002Fxss-prevention\u002FSKILL.md",[],[],{"skillNo":159,"name":160,"nameZh":6,"description":161,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":162,"categories":163,"keywords":164,"publishedAt":18},"01M7845ST1H37YHSXWWQ9N0V0S","wordpress-plugin-core","WordPress plugin development with hooks, security, REST API, custom post types. Use for plugin creation, $wpdb queries, Settings API, or encountering SQL injection, XSS, CSRF, nonce errors.","https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fwordpress-plugin-core\u002Fskills\u002Fwordpress-plugin-core\u002FSKILL.md",[],[],{"skillNo":166,"name":167,"nameZh":6,"description":168,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":169,"categories":170,"keywords":171,"publishedAt":18},"01M7845PTWD5HWSTGP35Q8TFNY","woocommerce-dev-cycle","Run tests, linting, and quality checks for WooCommerce development. Use when running tests, fixing code style, or following the development workflow in WooCommerce projects.","https:\u002F\u002Fgithub.com\u002Faibizmod\u002Faibizmod-service-web\u002Fblob\u002Fmain\u002F.opencode\u002Fskill\u002Fclaude-skills\u002Fplugins\u002Fwoocommerce-dev-cycle\u002Fskills\u002Fwoocommerce-dev-cycle\u002FSKILL.md",[],[]]