# Vue Doctor

> Use before committing Vue, Nuxt, Vite Vue, Vue CLI, Quasar, VitePress, or VuePress code, or when cleaning up Vue code quality. Checks for score regressions, security, correctness, performance, accessibility, bundle-size, design, and component architecture diagnostics. Use when this capability is needed.

- Skill: `tomevault-io/vue-doctor` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/vue-doctor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/vue-doctor/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/vue-doctor

---


# Vue Doctor

Vue Doctor scans Vue codebases and returns a 0-100 health score with actionable diagnostics.

## Quick Checks

Before committing Vue changes, run:

```bash
npx @rekl0w/vue-doctor@latest --verbose --diff
```

If the score drops or new errors appear, fix those regressions before committing.

## Full Scan

Run a full codebase scan when starting cleanup work:

```bash
npx @rekl0w/vue-doctor@latest --verbose --full
```

Fix errors first, then warnings. Use focused flags for automation:

| Flag | Purpose |
| --- | --- |
| `--diff [base]` | Scan changed Vue source files vs the base branch |
| `--staged` | Scan staged source files for pre-commit workflows |
| `--project <name>` | Scan one or more workspace projects |
| `--score` | Output only the numeric health score |
| `--json` | Output a structured machine-readable report |
| `--fail-on warning` | Fail on any diagnostic |

## Suppressions

Prefer fixing findings. When a suppression is intentional, keep it narrow:

```vue
<!-- vue-doctor-disable-next-line vue-doctor/no-v-html -->
<div v-html="trustedHtml" />
```

Use `--no-respect-inline-disables` for an audit scan that ignores local suppressions.

---
> Source: [Rekl0w/vue-doctor](https://github.com/Rekl0w/vue-doctor) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-24 -->

