# Vue Debug Guides

Vue 3 debugging and error handling for runtime errors, warnings, async failures, and...

- Repository: https://github.com/vuejs-ai/skills (3229 stars)
- Category: Testing
- License: MIT
- Last updated: 2026-10-23
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add vuejs-ai/skills --skill vue-debug-guides -g -a claude-code -y`
Codex: `npx skills add vuejs-ai/skills --skill vue-debug-guides -g -a codex -y`
Cursor: `npx skills add vuejs-ai/skills --skill vue-debug-guides -g -a cursor -y`
Gemini CLI: `npx skills add vuejs-ai/skills --skill vue-debug-guides -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add vuejs-ai/skills`

## Description

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

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

Vue 3 debugging and error handling for runtime issues, warnings, async failures, and hydration bugs.
For development best practices and common gotchas, use `vue-best-practices`.

### Reactivity
- Tracing unexpected re-renders and state updates → See [reactivity-debugging-hooks](reference/reactivity-debugging-hooks.md)
- Ref values not updating due to missing .value access → See [ref-value-access](reference/ref-value-access.md)
- State stops updating after destructuring reactive objects → See [reactive-destructuring](reference/reactive-destructuring.md)
- Refs inside arrays, Maps, or Sets not unwrapping → See [refs-in-collections-need-value](reference/refs-in-collections-need-value.md)
- Nested refs rendering as [object Object] in templates → See [template-ref-unwrapping-top-level](reference/template-ref-unwrapping-top-level.md)
- Reactive proxy identity comparisons always return false → See [reactivity-proxy-identity-hazard](reference/reactivity-proxy-identity-hazard.md)
- Third-party instances breaking when proxied → See [reactivity-markraw-for-non-reactive](reference/reactivity-markraw-for-non-reactive.md)
- Watchers only firing once per tick unexpectedly → See [reactivity-same-tick-batching](reference/reactivity-same-tick-batching.md)

### Computed
- Computed getter triggers mutations or requests unexpectedly → See [computed-no-side-effects](reference/computed-no-side-effects.md)
- Mutating computed values causes changes to disappear → See [computed-return-value-readonly](reference/computed-return-value-readonly.md)
- Computed value never updates after conditional logic → See [computed-conditional-dependencies](reference/computed-conditional-dependencies.md)
- Sorting or reversing arrays breaks original state → See [computed-array-mutation](reference/computed-array-mutation.md)
- Passing parameters to computed properties fails → See [computed-no-parameters](reference/computed-no-parameters.md)

The rest: https://github.com/vuejs-ai/skills/blob/HEAD/skills/vue-debug-guides/SKILL.md