All skills
vuejs-ai avatar

/vue-debug-guides

@a5fc891 official
by Vue AIvuejs-ai/skills2.9k stars
167

Vue 3 debugging and error handling for runtime errors, warnings, async failures, and SSR/hydration issues. Use when diagnosing or fixing Vue issues.

Use this Skill: https://skilld.dev/gh/vuejs-ai/skills/vue-debug-guides

This session only. Nothing lands on disk.

referencetemplate-expressions-restrictions.md

≈861 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Template Expressions Must Be Single Expressions

Impact: MEDIUM - Vue templates only support single JavaScript expressions, not statements. Using variable declarations, if statements, or multiple statements will cause template compilation errors.

Template interpolation {{ }} and directive bindings evaluate JavaScript expressions that produce a value. Statements like if, for, variable declarations, or multi-line code blocks are not allowed.

Task Checklist

  • Use only single expressions in {{ }} interpolation
  • Use ternary operators instead of if/else statements
  • Move complex logic to computed properties or methods
  • Avoid variable declarations in templates
  • Use v-if/v-else directives for conditional rendering

Incorrect:

<template>
  <!-- ERROR: Variable declaration is a statement, not expression -->
  <p>{{ var greeting = 'Hello' }}</p>
  <p>{{ let x = 1 }}</p>
  <p>{{ const name = 'Vue' }}</p>

  <!-- ERROR: if statement not allowed -->
  <p>{{ if (ok) { return message } }}</p>
  <p>{{ if (user) return user.name }}</p>

  <!-- ERROR: Multiple statements not allowed -->
  <p>{{ count++; return count }}</p>
  <p>{{ items.push(newItem); items.length }}</p>

  <!-- ERROR: for/while loops not allowed -->
  <p>{{ for (let i = 0; i < 5; i++) { } }}</p>
</template>

Correct:

<template>
  <!-- OK: Simple expressions -->
  <p>{{ message }}</p>
  <p>{{ count + 1 }}</p>
  <p>{{ items.length }}</p>

  <!-- OK: Ternary operators for conditionals -->
  <p>{{ ok ? 'YES' : 'NO' }}</p>
  <p>{{ user ? user.name : 'Guest' }}</p>
  <p>{{ score >= 60 ? 'Pass' : 'Fail' }}</p>

  <!-- OK: Method/function calls -->
  <p>{{ formatDate(date) }}</p>
  <p>{{ items.filter(i => i.active).length }}</p>

  <!-- OK: Chained expressions -->
  <p>{{ message.split('').reverse().join('') }}</p>

  <!-- OK: Template literals -->
  <p>{{ `Hello, ${name}!` }}</p>

  <!-- OK: Object/array expressions -->
  <p>{{ { name: 'Vue', version: 3 } }}</p>
</template>

<script setup>
import { ref, computed } from 'vue'

const ok = ref(true)
const message = ref('Hello')
const user = ref({ name: 'Alice' })
const score = ref(85)

// Move complex logic to computed properties
const greeting = computed(() => {
  if (user.value) {
    return `Welcome back, ${user.value.name}!`
  }
  return 'Hello, Guest!'
})

// Or use methods for reusable logic
function formatDate(date) {
  return new Date(date).toLocaleDateString()
}
</script>

Use Directives for Control Flow

<template>
  <!-- Instead of if/else in expressions, use v-if/v-else -->
  <p v-if="user">Welcome, {{ user.name }}!</p>
  <p v-else>Please log in</p>

  <!-- Instead of loops in expressions, use v-for -->
  <ul>
    <li v-for="item in items" :key="item.id">{{ item.name }}</li>
  </ul>

  <!-- Conditional display without removing from DOM -->
  <p v-show="isVisible">This toggles visibility</p>
</template>

Reference

Source: SKILL.md on GitHub

1 warning17d5 checks · Risk SAFE
  • Gen Agent Trust Hub17d

    This skill is a comprehensive collection of educational debugging guides and best practices for Vue 3 developers. It contains no executable code or malicious instructions and focuses solely on diagnosing common runtime errors and performance issues.

  • Socket17d

    No alerts

  • Snyk17d

    Risk: LOW · No issues

  • Runlayer7mo

    140/140 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at a5fc891. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Steadyupdated 8 months ago

README badge

README badge for vuejs-ai/skills/vue-debug-guides

Guides for diagnosing Vue 3 runtime errors, reactivity bugs, component lifecycle issues, and SSR hydration problems. Covers reactivity traps (refs, computed, watchers), component mechanics (props, emits, slots), templates (v-if, v-for, refs), forms (v-model), and composition API gotchas.

Generated from the current SKILL.md.

Does this cover Vue 2 or only Vue 3?
This skill is for Vue 3 only. It addresses Vue 3-specific debugging patterns like reactivity proxies, script setup, and defineEmits/defineProps.
Does this skill help with performance optimization?
No. This skill focuses on runtime errors, warnings, and behavioral bugs. For development best practices and optimization, use the separate `vue-best-practices` skill.
What kinds of issues does this cover?
Reactivity traps (refs, computed, watchers), component lifecycle bugs, template directives, form binding edge cases, SSR/hydration mismatches, slot scoping, and async-related failures.
Does this include debugging for Nuxt or other Vue frameworks?
No. This skill focuses on core Vue 3 runtime issues. Framework-specific bugs are outside its scope.

Generated from the current SKILL.md. These answers refresh after source changes.