vue-frontend-expert

Expert guide for Vue 3 (Composition API), Nuxt 3, and Pinia. Covers advanced reactive state management, `<script setup>` syntax, Vue Router, VueUse, and SPA/SSR architectural patterns in English and I

SKILL.md

GitHub

Vue Frontend Expert (Vue 3 / Nuxt 3)

English | Bahasa Indonesia


<a name="english"></a>

English

Orchestration & Integration

Connects and orchestrates with relevant domain skills:

  • modern-web-guidance — HTML5/CSS standards, modern browser APIs, and accessibility guidelines.
  • design-system-architect — Building headless UI components using Radix Vue or VueUse components.
  • modern-css-native-expert — Native CSS anchor positioning, View Transitions, container queries, and @starting-style.
  • tailwind-expert — Styling Vue/Nuxt components with Tailwind CSS v4.
  • ui-ux-pro-max — Design intelligence, layout hierarchies, and Vue component tokens.
  • visual-ui-auditor — Multimodal vision auditing of rendered Vue/Nuxt views.
  • anti-slop — Anti-slop component craft, zero placeholder stubs, complete reactivity implementations.
  • performance-web-vitals — Optimizing Nuxt 3 SSR metrics (LCP, INP, CLS).

Description

Production-grade guidance for building highly reactive and scalable frontend applications using Vue 3 (Composition API) and Nuxt 3. Covers the latest ecosystem tools including Pinia for state management, VueUse for composables, and Tailwind CSS v4 integration.

Trigger Conditions

Activate this skill when the user is:

  • Scaffolding a new Vue 3 or Nuxt 3 project.
  • Writing or refactoring Vue components using <script setup> and Composition API.
  • Managing global state with Pinia.
  • Handling client-side routing with Vue Router or Nuxt's file-based routing.
  • Implementing SSR (Server-Side Rendering) or SSG (Static Site Generation) using Nuxt 3.

Core Concepts

1. Vue 3 Composition API & <script setup>

Use the <script setup> syntax by default. It provides better type inference, less boilerplate, and superior performance compared to the Options API.

<script setup lang="ts">
import { ref, computed, onMounted } from 'vue'

const count = ref(0)
const doubleCount = computed(() => count.value * 2)

function increment() {
  count.value++
}

onMounted(() => {
  console.log('Component is mounted!')
})
</script>

<template>
  <button @click="increment">Count is: {{ count }} (Double: {{ doubleCount }})</button>
</template>

2. Global State Management (Pinia)

Pinia is the official state management library for Vue. Avoid Vuex in modern applications.

// stores/counter.ts
import { defineStore } from 'pinia'
import { ref, computed } from 'vue'

export const useCounterStore = defineStore('counter', () => {
  const count = ref(0)
  const doubleCount = computed(() => count.value * 2)
  function increment() {
    count.value++
  }

  return { count, doubleCount, increment }
})

3. Nuxt 3 Architecture

For SSR, SEO optimization, and file-based routing, use Nuxt 3.

  • Data fetching: Use useAsyncData or useFetch to prevent hydration mismatches.
  • Server API: Utilize the server/api/ directory for Nitro API routes.

4. The VueUse Collection

Always leverage VueUse for common composables (e.g., useWindowSize, onClickOutside, useStorage) instead of writing custom composables from scratch.


Best Practices

  1. Ref vs Reactive: Prefer ref for primitive values and reactive for deeply nested objects. When in doubt, default to ref.
  2. Define Macros: Use defineProps and defineEmits in <script setup> for typed props and events.
  3. Avoid Watchers when possible: Rely on computed properties instead of watch to derive state. Use watch only for side-effects (e.g., API calls, DOM manipulation).
  4. V-Model: Use the updated v-model binding in Vue 3.4+ with defineModel() for cleaner two-way data binding between components.

Sovereign Execution, Token Efficiency & Invariants

Dimension Sovereign Mandate & Deterministic Contract
Frontier Model Cascade Medium / High (Gemini 4 Argon, Claude Sonnet 5.5 High, Muse Wonder High, Composer 2.5 Fast)
Availability Fallback Gemini 4 Argon/Pro -> Gemini 3.8 Flash; Claude Opus 5.5 -> Claude Opus 4.6 (Zero unhandled missing-model errors)
KV-Cache & Token Protocol Pin static instructions & schemas at prompt prefix (kv-cache-prefix-optimizer); pass surgical CONTEXT_MAP.md slices (<250 tokens/call) during Swarm Fan-Out
SaaT CLI & MCP Dispatch CLI: vibes skill exec vue-frontend-expert <audit|eval|verify|generate|blueprint> / MCP: vibes_skill_dispatch, vibes_visual_audit, vibes_ast_query, vibes_verify_gate
NFR & Anti-Slop Invariants LCP < 1.8s, INP < 100ms, CLS < 0.05, 1px crisp borders, 3-tier radius (6px/8px/12px), tabular-nums, 5-state interactive contract; 100% complete zero-placeholder output verified via node scripts/check-anti-slop.js --strict

<a name="bahasa-indonesia"></a>

Bahasa Indonesia

Integrasi Orkestrasi

Terhubung dan mengorkestrasi skill domain yang relevan:

  • modern-web-guidance — Standar HTML5/CSS, API browser modern, dan pedoman aksesibilitas.
  • design-system-architect — Komponen headless UI menggunakan Radix Vue atau VueUse.
  • modern-css-native-expert — CSS anchor positioning native, View Transitions, container queries, dan @starting-style.
  • tailwind-expert — Penataan gaya komponen Vue/Nuxt dengan Tailwind CSS v4.
  • ui-ux-pro-max — Kecerdasan desain UI/UX, hierarki tata letak, dan token komponen Vue.
  • visual-ui-auditor — Audit visual multimodal untuk tampilan antarmuka Vue/Nuxt yang dirender.
  • anti-slop — Penegakan anti-slop, nol stub atau placeholder, implementasi reaktivitas penuh.
  • performance-web-vitals — Optimasi metrik SSR Nuxt 3 (LCP, INP, CLS).

Deskripsi

Panduan tingkat produksi untuk membangun aplikasi frontend reaktif dan terukur menggunakan Vue 3 (Composition API) dan Nuxt 3. Mencakup pengelolaan state dengan Pinia, utilitas VueUse, dan integrasi Tailwind CSS v4.

Kondisi Pemicu

Aktifkan skill ini ketika pengguna sedang:

  • Memulai proyek Vue 3 atau Nuxt 3 baru.
  • Menulis ulang (refactoring) komponen ke <script setup> dan Composition API.
  • Mengelola state global dengan Pinia (bukan Vuex).
  • Menerapkan SSR (Server-Side Rendering) dengan Nuxt 3.

Implementasi Pola Kunci (Vue 3 & Nuxt 3)

1. Komponen Reaktif Modern dengan <script setup lang="ts">

<script setup lang="ts">
import { ref, computed, onMounted } from 'vue'

const jumlah = ref(0)
const kelipatanDua = computed(() => jumlah.value * 2)

function tambah() {
  jumlah.value++
}

onMounted(() => {
  console.log('Komponen Vue 3 berhasil dimuat!')
})
</script>

<template>
  <button 
    @click="tambah"
    class="px-4 py-2 bg-slate-900 text-white dark:bg-slate-100 dark:text-slate-900 rounded font-medium"
  >
    Jumlah: {{ jumlah }} (Kelipatan: {{ kelipatanDua }})
  </button>
</template>

2. Store Global Pinia dengan Pola Setup Store

// stores/counter.ts
import { defineStore } from 'pinia'
import { ref, computed } from 'vue'

export const useCounterStore = defineStore('counter', () => {
  const count = ref(0)
  const doubleCount = computed(() => count.value * 2)
  function increment() {
    count.value++
  }

  return { count, doubleCount, increment }
})

Matriks Eksekusi Berdaulat, Efisiensi Token & Invarian

Dimensi Mandat Berdaulat & Kontrak Deterministik
Kaskade Model Frontier Medium / High (Gemini 4 Argon, Claude Sonnet 5.5 High, Muse Wonder High, Composer 2.5 Fast)
Invarian Fallback Ketersediaan Gemini 4 Argon/Pro -> Gemini 3.8 Flash; Claude Opus 5.5 -> Claude Opus 4.6 (Bebas gagal saat model belum tersedia/kuota penuh)
Protokol Hemat Token & KV-Cache Kunci instruksi & skema statis di prefix awal (kv-cache-prefix-optimizer); kirim potongan CONTEXT_MAP.md (<250 token/panggilan) saat Fan-Out
Eksekusi SaaT CLI & MCP CLI: vibes skill exec vue-frontend-expert <audit|eval|verify|generate|blueprint> / MCP: vibes_skill_dispatch, vibes_visual_audit, vibes_ast_query, vibes_verify_gate
Invarian NFR & Anti-Slop LCP < 1.8s, INP < 100ms, CLS < 0.05, border tegas 1px, radius 3-tier (6px/8px/12px), tabular-nums, kontrak interaktif 5-state; kode 100% tuntas tanpa placeholder diverifikasi melalui node scripts/check-anti-slop.js --strict