vue-debug-guides (vuejs-ai): a skill that looks up fixes for Vue 3 bugs and warnings

vue-debug-guides gives your agent a lookup of 139 Vue 3 bug guides, so it can match your error or symptom to a known cause and fix.

Installs: 27.4K; on skills.sh
Stars: 3.2K; on GitHub
Files: 60+; besides SKILL.md
Updated: Oct 2026; last repo commit

The skill is an index. SKILL.md lists symptoms in plain words, such as "ref values not updating" or "scoped styles not applying to slot content", and each line links to a short guide in reference/. There are 139 guides across 28 groups, from reactivity, computed and watchers to slots, v-model, SSR, TypeScript, plugins and app configuration. The agent reads the guide that matches your symptom and applies it.

It triggers when you diagnose or fix a Vue 3 issue. For general best practices it points to the separate vue-best-practices skill. The README says to start your prompt with "use vue skill" for the most reliable trigger. It bundles no scripts.

Good for

Vue 3 developers chasing a runtime error, warning or odd re-render
Teams fixing SSR and hydration mismatches
Developers new to Vue reactivity, computed, watchers and slots

Install vue-debug-guides

Claude Code

Copy this prompt.

Install the vue-debug-guides skill in Claude Code. Run this command:

npx skills add https://github.com/vuejs-ai/skills --skill vue-debug-guides

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

From its listing on skills.sh. Source.

What's in the skill

When it loads

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

Sections in SKILL.md

Reactivity
Computed
Watchers
Components
Props & Emits
Templates
Template Refs
Forms & v-model
Events & Modifiers
Lifecycle
Slots
Provide/Inject
Attrs
Composables
Composition API
Animation

Key facts

Author: vuejs-ai (github.com/vuejs-ai)
Repo: vuejs-ai/skills, path skills/vue-debug-guides
Version in SKILL.md: 19.0.1
Installs on skills.sh: 27,376 (as of Nov 2, 2026)
GitHub stars: 3,229 (shared repo, Nov 2, 2026)
License: MIT
Last repo commit: Oct 23, 2026
skills.sh audits: Gen Agent Trust Hub: pass. Socket: pass. Snyk: pass.
Files: 140 including SKILL.md: 139 guides under reference/ (no scripts)
Project status: README calls the repo an early experiment and community project

What it includes

Re-render tracing, .value access, destructuring, computed pitfalls
Eight reactivity guides and five computed guides, for example refs in collections and proxy identity.
Reactivity and Computed
Stale async results, flush timing, deep and getter watchers
Seven guides, including watchEffect dependency tracking after await.
Watchers
Registration, defineExpose, defineProps and defineEmits rules
Includes undeclared emits that fire twice and native event collisions.
Components, Props and Emits
v-if, v-for, directives, refs in loops and slot scope
Includes v-if with v-for precedence, missing keys and scoped slot props.
Templates, Template Refs and Slots
v-model, modifiers, mount timing and cleanup
Includes IME input, number modifiers, event modifier order and nextTick timing.
Forms, Events and Lifecycle
Setup-time rules and fallthrough attributes
Includes synchronous provide, inheritAttrs and composable call-location limits.
Provide/Inject, Attrs, Composables, Composition API
Typing and lazy-loading pitfalls
Includes withDefaults factories and defineAsyncComponent with the router.
TypeScript, Async Components, Render Functions
Built-in component and motion pitfalls
Nine transition guides, three each for Teleport and Suspense, and two each for animation and KeepAlive, for example JS hook done callbacks and unmount timing.
Animation, KeepAlive, Transitions, Teleport, Suspense
Hydration, prop stability, scoped CSS, install order
Includes browser-only APIs on the server and Tailwind classes built dynamically.
SSR, Performance, SFC, Plugins, App Config

From the official docs

Questions

What does vue-debug-guides do?

It gives your agent an index of 139 short Vue 3 debugging guides. The agent matches your error or symptom to a guide and uses it to explain the cause and the fix.

How do I install it in Claude Code?

Use the install command in the box above, which installs this skill alone. The README also lists a plugin marketplace route with a bundle of all the Vue skills.

Does it work with Vue 2 or the Options API?

SKILL.md is about Vue 3. The README lists a separate vue-options-api-best-practices skill for Options API work.

Is it safe?

It bundles no scripts: it is one SKILL.md and 139 guide files. It reads and edits your Vue code the way your assistant normally would, so review the changes it proposes.

How do I make sure it triggers?

The README says to start your prompt with "use vue skill". Without it, triggering may be inconsistent.

How reliable is it?

The README calls the repo an early experiment and community project. It says the skills come from real-world issues but may be incomplete because of hallucinations, and it asks for feedback. Check advice against the Vue docs.

Does it need vue-best-practices?

No. SKILL.md points to vue-best-practices for development best practices and gotchas, and the debug skill works on its own.

Information

updated Nov 2, 2026

Repository: vuejs-ai/skills
Folder: skills/vue-debug-guides

vuejs-ai/skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 2

SKILL.md · github.com
vuejs-ai/skills README · github.com